Admin permissions reference
Reference of all organization-level permissions available in Retool roles.
Organization roles grant access to organization-wide settings. You configure them from Settings > Roles. To control access to apps, resources, workflows, and agents, refer to Object permissions.
The Plan column shows the minimum plan required to use each permission. Business+ means the permission is available on Business and Enterprise plans. Enterprise means it requires an Enterprise plan.
Some permissions automatically include others. When you select a parent permission, all child permissions are included:
- Edit queries includes View queries.
- Manage billing includes Manage user seats.
The UI automatically handles these dependencies when you configure roles.
Organization permissions
Organization permission scopes control access to administrative settings pages.
User management
| Permission | Description | Plan |
|---|---|---|
| Manage single sign-on (SSO) | Configure single sign-on integrations. | Enterprise |
| Manage user attributes | Define and manage custom user attributes. | Enterprise |
| View account details | View and manage account details. | Business+ |
| View users page with emails | View the users page with user emails. | Business+ |
Example
Create an Identity Manager role for your IT team to manage SSO and user provisioning without full admin access.
Query library
| Permission | Description | Plan |
|---|---|---|
| Edit queries | Create, edit, and delete queries in the library. | Business+ |
| View queries | View and use queries from the library. | Business+ |
Example
Create a Query Developer role for database experts to manage shared query templates.
Organization configuration
| Permission | Description | Plan |
|---|---|---|
| Manage Spaces | Configure and manage Spaces. | Enterprise |
| Manage internationalization | Configure language and localization settings. | Enterprise |
| Manage Retool API | Manage API access tokens and settings. | Enterprise |
| Manage source control | Configure Git integrations. | Enterprise |
| Manage usage analytics | View and configure analytics. | Business+ |
| Manage billing | View and manage billing settings. | Enterprise |
| Manage user seats | Assign and modify user seat types (builder, internal, or external). | Enterprise |
| View audit logs | Access audit log data. | Business+ |
Example
Create a Finance Admin role that grants access to billing and usage analytics only, allowing your finance team to monitor costs without accessing other settings.
Customization
| Permission | Description | Plan |
|---|---|---|
| Manage branding | Configure organization branding and styling. | Enterprise |
| Manage themes | Create and edit custom themes. | Business+ |
| Manage Retool Events | Configure and manage Retool Events. | Enterprise |
| Manage Retool External | Configure external user access and APIs. | Enterprise |
| Manage custom components libraries | Manage custom component libraries. | Enterprise |
Example
Create a Design Manager role for your design team to manage branding and themes.
Configuration
| Permission | Description | Plan |
|---|---|---|
| Allow access to unpublished releases | Grant access to edge/unpublished releases. | Business+ |
| Manage environments | Configure resource environments. | Enterprise |
| Manage configuration variables | Manage config variables. | Enterprise |
| Manage Retool AI | Configure AI features and settings. | Enterprise |
| Manage IAM credentials | Manage secrets and IAM integrations. | Enterprise |
| Manage observability | Configure monitoring and observability. | Enterprise |
Example
Create a DevOps Manager role that grants access to environments, config variables, and IAM credentials for your operations team.
Additional settings
| Permission | Description | Plan |
|---|---|---|
| Manage advanced settings | Access advanced organization settings. | Enterprise |
| Manage mobile settings | Configure mobile app settings. | Enterprise |
| Manage beta settings | Access and configure beta features. | Enterprise |
| Manage draft apps | Control draft app access and settings. | Business+ |
App builder role
| Permission | Description | Plan |
|---|---|---|
| Updated app builder | Control access to the updated app builder. | Business+ |