admin of Retool you can use Permission Groups to control which users have access to which apps and resources. See Inviting users and authentication to learn how to invite users to Retool.
If you can't see Settings > Permissions you are not an
admin and will not be able to perform the tasks described in this guide.
Figure 1. Settings > Permissions.
All Retool user accounts are added to the
All Users group when first created. By default this group has
editor permissions (explained below) on all apps. Additionally, by default this group can write queries against all resources when editing an app. You can edit the permissions of the
All Users group so that users don't have edit permissions on all apps and query write permissions on all resources when invited.
Retool also provides the following non-editable default groups:
viewercan use all apps.
editorcan use and edit all apps and can write queries against all resources when editing an app.
admincan use all apps, edit them, write queries against all resources, invite users, and change user permissions. The first user who signs up for Retool is an
When using the on-premise version of Retool, an
admin must invite users. Anyone who signs in without an invite is assigned no permissions by default. See On-premise.
When using the cloud version of Retool, anyone who signs in is assigned as a
viewer by default. See Cloud.e
- Open Settings > Permissions.
- Click Create New Group.
- Give the new group a name.
Figure 2. Creating a new group called
- Click Create.
- Click the row containing your new group in order to select it. The Group Details section shows more information about your new group.
- Use Group Details > Apps to control how much access the group has to each app.
Figure 3. Using Group Details > Apps to specify that the
auditor group should have
own access to
Sample GSheets App,
edit access to
Sample Users Page, and
use access to
- Use Group Details > Resources to control which resources the group can write queries agains when an app is in edit mode.
Figure 4. Using Group Details > Resources to specify that the
auditor group should be able to write queries against the
onboarding_db (edit) resource.
- Click Save to confirm your changes.
- Open Settings > Users.
- Click the user whose groups you want to edit. Retool highlights the user's row to indicate that it's selected. The User Details pane shows more information about that particular user.
Figure 5. Viewing the User Details for the
Sales Guy user.
- Use the Permissions Groups text box to edit the user's groups.
- Open Settings > Permissions.
- Click the group that you want to edit. Retool highlight's the row blue to indicate that it's selected. The Group Details pane shows more information about that particular group.
Figure 6. Viewing the Group Details for the
- Enable the checkbox next to a user's name in Groups Details > Users to add that user to that group. Disable the checkbox to remove that user from that group.
When inviting users to Retool, click Add Group and then specify which groups they belong to in the Groups to add invited members to text box.
Figure 7. Adding
firstname.lastname@example.org to the
QA group when inviting her.