Skip to main content

Admin permissions reference

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.

Note

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​

PermissionDescriptionPlan
Manage single sign-on (SSO)Configure single sign-on integrations.Enterprise
Manage user attributesDefine and manage custom user attributes.Enterprise
View account detailsView and manage account details.Business+
View users page with emailsView 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​

PermissionDescriptionPlan
Edit queriesCreate, edit, and delete queries in the library.Business+
View queriesView and use queries from the library.Business+
Example

Create a Query Developer role for database experts to manage shared query templates.

Organization configuration​

PermissionDescriptionPlan
Manage SpacesConfigure and manage Spaces.Enterprise
Manage internationalizationConfigure language and localization settings.Enterprise
Manage Retool APIManage API access tokens and settings.Enterprise
Manage source controlConfigure Git integrations.Enterprise
Manage usage analyticsView and configure analytics.Business+
Manage billingView and manage billing settings.Enterprise
Manage user seatsAssign and modify user seat types (builder, internal, or external).Enterprise
View audit logsAccess 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​

PermissionDescriptionPlan
Manage brandingConfigure organization branding and styling.Enterprise
Manage themesCreate and edit custom themes.Business+
Manage Retool EventsConfigure and manage Retool Events.Enterprise
Manage Retool ExternalConfigure external user access and APIs.Enterprise
Manage custom components librariesManage custom component libraries.Enterprise
Example

Create a Design Manager role for your design team to manage branding and themes.

Configuration​

PermissionDescriptionPlan
Allow access to unpublished releasesGrant access to edge/unpublished releases.Business+
Manage environmentsConfigure resource environments.Enterprise
Manage configuration variablesManage config variables.Enterprise
Manage Retool AIConfigure AI features and settings.Enterprise
Manage IAM credentialsManage secrets and IAM integrations.Enterprise
Manage observabilityConfigure 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​

PermissionDescriptionPlan
Manage advanced settingsAccess advanced organization settings.Enterprise
Manage mobile settingsConfigure mobile app settings.Enterprise
Manage beta settingsAccess and configure beta features.Enterprise
Manage draft appsControl draft app access and settings.Business+

App builder role​

PermissionDescriptionPlan
Updated app builderControl access to the updated app builder.Business+