Supported URL query parameters

A list of supported URL query parameters. Example usage:

https://yourcompany.retool.com/apps/my-app?_environment=staging

Parameter name

Accepted Values

Usage notes

_historyOffset

Any integer, e.g. 1, 2, 5, etc

Opens the Retool app a number of changes back in the page save history. This is useful if your app gets to a bad state (e.g. infinite loop) and you can't roll back changes via the UI.

Confusion alert: If you edit an app while in an offset version, those changes will be saved at the "newest" position in the app history

_embed

true or false

Hides all non-app UI. Useful for embedding Retool into other applications.

_releaseVersion

Any valid release number, e.g. latest, 0.1.1, 2.0.0

Opens the Retool app to a specific release version. Helpful for testing or sharing new changes with teammates.

_environment

staging or production

Opens the Retool app with the staging or production credentials. This is the same as clicking the "staging / production" toggle via the UI.

In addition to these supported query parameters, you can define your own query parameters and use them in your app here: https://docs.retool.com/docs/deep-links.


Did this page help you?