Skip to main content

Publish an app

By default, all apps are created in your Drafts folder in an unpublished state. In order for other users to see and use your app, you must publish it.

You must be a builder to publish an app. Internal users can create apps, but they cannot publish them.

Publish your app

To publish your app, click Publish in the top right corner of the app builder. Complete the following steps in the modal that appears:

  1. Review the Publish checklist. Retool performs several checks to ensure that your app is ready to publish:
    1. Your changes do not conflict with the published version changes from other users. If there is a new published version of your app, click Integrate changes to ask the agent to resolve the conflict.
    2. All function runs are approved. If there are unapproved functions, click Review functions to view the functions that still need approval.
  2. Define a descriptive name for the App URL.
    1. For cloud instances, URLs are constructed in the following format: <spaceName>--<orgSubdomain>--<appName>.retool.app.
    2. For self-hosted instances, URLs are constructed in the following format: s<spaceName>.<orgDomain>/rr/app/<appName>.
  3. Choose the folder in which you want your published app to be available, and confirm your selection. All users with use access to the folder you select will be able to use your app.
  4. Click Publish.

Once you publish your app, your thread is considered closed, and further prompting is disabled. Create a new thread to continue iterating on your app. Learn more about threads.

Restore a previous version

To restore your app to a previous version, click . In the Version History pane, click the Publish history tab to view the published versions of your app.

Hover over the version that you want to restore, and click Restore. A new copy of the app is promoted to the currently published version.

Any further changes to your app apply to this version, and you can publish new versions as normal.