Skip to main content

Built-in URL parameters

Learn about built-in URL parameters to control app behavior.

Public apps do not support built-in URL parameters.

Use built-in URL search parameters to control certain app characteristics when launched, such as loading a specific release or environment. Append ? to the app's URL and include the parameters as key=value pairs. Separate multiple parameters with &.

Refer to the URL parameters guide for information on configuring custom parameters for use in apps.

_embed

boolean

Hides all non-app UI elements, such as the Retool header. Falls back to false if not set.


_environment

string

The environment to load (e.g., staging). Falls back to production if not set.


_hideNav

boolean

Hides the Retool navigation bar. Falls back to false if not set.


_hideTimer

boolean

Hides the status bar which contains the query timer. Falls back to false if not set.


_historyOffset

number

Opens the Retool app to a previous point in its save history state. Only applies when launching an app with the latest release version.


_releaseVersion

string

The release version of the app to load. Falls back to the most recent live version or latest if not set