Set up object permissions
Learn how to create a group and grant it object permissions to control access to apps, resources, workflows, and agents in Retool.
This tutorial walks you through setting up object permissions for a team in your Retool organization. You'll create a custom group and grant it permissions on objects, both as universal access and as individual access scoped to specific objects.
The object permissions feature is not yet available on self-hosted instances.
Scenario: Your organization has a Data Engineering team. You want them to have Edit access to all resources (so they can work with any data source) but only Use access to apps (so they can run apps but not modify them). You also want to scope their workflow access to a specific folder.
Prerequisites
- Retool Business or Enterprise plan
- Organization admin access
- Object Permissions enabled (available from Retool 3.380)
Create a group
First, create a group for your Data Engineering team.
- Navigate to Settings > Groups.
- Click Create group.
- Enter
Data Engineeringas the group name. - Click Create.
The new group appears in your groups list. It has no members and no permissions yet.
Add members to the group
- Select the Data Engineering group.
- Click Add new members.
- Search for and select the users on your data engineering team.
- Click Add to group.
You can also add pending invites. Users who haven't accepted yet will automatically inherit the group's permissions when they join.
Grant universal access
Give your group universal access to the object types where the whole team needs the same permission level.
- Navigate to Settings > Groups and select Data Engineering.
- Go to the Object permissions tab.
- Click Edit permissions.
- Click Universal access.
- Set Resources to Edit and Apps to Use.
- Click Review changes, then click Confirm.
All current and future members of the Data Engineering group now have Edit permission on every resource and Use permission on every app, including resources and apps created later.
Grant individual access to a workflow folder
Your team needs Edit permission on a specific workflow folder, but not to all workflows. Grant access to the Data Pipelines folder only.
- On the Object permissions tab, click Edit permissions.
- In Search objects, enter
Data Pipelines. - Set the access level for the
Data Pipelinesfolder to Edit. - Click Review changes, then click Confirm.
Granting access to a folder applies to all workflows within it, including workflows added later. If a workflow is moved out of the folder, it no longer inherits this permission.
Verify access
Check that the permissions are configured correctly.
- On the group's Object permissions tab, review the list of everything the group can access, organized by type.
- To verify a specific user's effective permissions, go to Settings > Users, select a member of the Data Engineering group, and open their Object permissions tab. Each row shows where the user's access comes from.
What you built
Your Data Engineering group now has:
| Object | Permission level | Scope |
|---|---|---|
| All resources | Edit | Universal |
| All apps | Use | Universal |
| Data Pipelines workflow folder | Edit | Individual |
Members can connect to any resource and run queries, run any app as an end user, and build and edit workflows in the Data Pipelines folder, without any broader access to modify apps or manage the organization.
Next steps
- Manage object permissions: Full reference for granting and reviewing a group's access.
- Object permissions concept guide: Understand universal vs. individual access and folder inheritance in depth.
- Manage RBAC with the Retool API: Automate role and permission setup programmatically.