Using Multiple Polling URLs
Plugins that use the polling strategy can provide multiple URLs, line-break separated, to get data from multiple sources or endpoints to create a more robust plugin. For example:
This provides data in Your Variables for each URL under an indexed object in the format IDX_#
, where the # is incremented from 0. So, if you have 4 URLs, like in the example above, you would have data in Your Variables like:
{{ IDX_0 }}
{{ IDX_1 }}
{{ IDX_2 }}
{{ IDX_3 }}
{{ trmnl }}
URL Data Missing, Less IDX_#
Variables Than Expected
In the normal plugin flow of screen generation, this would not be noticeable because our renderer would not generate a screen until all the data was retrieved (assuming no errors with unreachable URLs).
However, if you were building a plugin and ran a Force Refresh, then went into Edit Markup relatively quickly, the system may still be loading all of the URLs. The solution is to wait 2-3 seconds (cumulatively per URL), then refresh the markup editor page. Remember: The data is not being refreshed in your browser, but via our backend servers, and then, once collected, becomes visible in your browser inside the web app.
Variables Being Overwritten
This can only occur for plugins created before August 19, 2025
Using the polling strategy with multiple polling URLs, if you changed the order of the line-separated URLs in your plugin later on, it could cause the data indexes to be overwritten in the resulting data shown in Your Variables.
This was visible if Debug Logging was enabled in your plugin settings page and a Force Refresh was run.
This was an elusive bug that has been resolved as of August 19, 2025. However, if your plugin has been affected by this bug, you will need to send a special command to our servers using a URL query string to fix the issue.
Plugin Settings URL Format: https://usetrmnl.com/plugin_settings/{{pluginId}}/edit
Example: https://usetrmnl.com/plugin_settings/987654321/edit
You will need to append ?reset_polling_url_namespaces=true
to the end of the browser URL:
Example: https://usetrmnl.com/plugin_settings/987654321/edit?reset_polling_url_namespaces=true
Once appended to the end of the URL in your browser, press Enter.
You will receive a notification that it has been completed:
You can now Force Refresh to collect the data again, accurately.