Manage per-page permissions in multipage apps

Learn how to configure page permissions in multipage apps.

Admins can configure Use access to each page of multipage apps.

To do so, create a permissions group and open the Apps tab. Click next to each app to see all of its pages. Select Use for each page that you want users in that group to be able to view.

Users who attempt to access a page for which they do not have Use permission are redirected to another page in the app for which they do have access.

Per-page Edit or Own permissions are not available.

Configure page permissions with Source Control

In order to support per-page permissioning, Retool added a universally unique identifier (UUID) for each page. Before you configure per-page permissions for an existing app that is protected with Source Control, first create a new branch with no changes and push it to Source Control. If your version of Retool is later than 3.191-edge, Retool automatially creates a migration commit that adds UUIDs to each page.

Once you merge this commit, you can successfully configure per-page permissions on your protected app.

If you are working on more than one branch before the UUID addition in version 3.191-edge, Retool runs the migration on each of those branches, and the branches will end up with different UUIDs. Make sure add UUIDs only once, do not override the UUIDs on the main branch after adding them. Doing so results in the inability to set per-page permissions, because the IDs initially set on main are the ones that Retool will use.