Skip to main content

Manage object permissions

note

The object permissions feature is not yet available on self-hosted instances. It's available to Enterprise or Business plan customers who have signed an annual agreement with a member of the Retool sales team. If you're on a self-service Business plan, contact the Retool sales team to learn more.

Manage a group's access to apps, resources, workflows, and agents from the Object permissions tab on the group's detail page. You set a permission level for individual objects and folders, or for every object of a type. Only organization admins can change a group's object permissions.

Object permissions are managed from Settings > Groups. The Roles page manages organization permissions only. For more information, refer to Object permissions.

Edit a group's object permissions​

Use the Edit permissions modal to set a group's permission level on individual apps, resources, workflows, agents, and folders.

  1. Navigate to Settings > Groups and select a group.
  2. Go to the Object permissions tab.
  3. Click Edit permissions. The modal opens and lists the objects in your organization, with folders you can expand.
  4. Find the objects you want to change:
    • Enter a name in Search objects.
    • Use the All types filter to show only one type of object.
    • Use the All access levels filter to show objects with a specific permission level.
  5. Set a permission level:
    • To change one object, select a level from the dropdown on its row: No access, Use, Edit, or Own.
    • To change several objects at once, select their checkboxes, click Assign access level, and choose a level. Select the checkbox at the top of the list to select every object that matches your filters.
  6. Click Review changes.
  7. Check the summary of changes, then click Confirm.

The modal shows how many objects you have selected next to Assign access level. Click Clear selection to deselect them. The footer shows a count of the changes you stage. Retool saves nothing until you confirm.

If a parent app or folder already gives the group a permission level, you can't select that level or lower on its child objects. Hover over a disabled option to see where the access is inherited from. To remove inherited access, change the access on the parent.

note

You can change up to 500 objects in one save.

Grant access to resource environments​

A resource has one configuration for each resource environment. In the Edit permissions modal, each resource appears as one row per resource environment, with a badge that shows the environment. You set a permission level on each row, so a group can have different access to the same resource in staging and production. For example, give a group Use access to a resource in staging and No access in production.

  1. Add the environment configuration to the existing resource, if it doesn't have one yet. You don't create a second resource.
  2. Navigate to Settings > Groups and select a group.
  3. Go to the Object permissions tab and click Edit permissions.
  4. Find the resource. Use the All types filter to show only resources.
  5. Set a permission level on each resource environment row you want the group to access.
  6. Click Review changes, then click Confirm.

Grant universal access​

Universal access gives a group the same permission level on every object of a type, including objects created later.

  1. Navigate to Settings > Groups and select a group.
  2. Go to the Object permissions tab and click Edit permissions.
  3. Click Universal access at the top right of the modal.
  4. For each object type you want to cover, select a permission level: No access, Use, Edit, or Own. The menu lists Apps, Workflows, Resources, and Agents.
  5. Click Review changes.
  6. If the group has individual access to objects of that type, Retool lists the assignments that saving removes. Check the list, then click Confirm.

A blue dot appears next to Universal access when you have unsaved changes.

To switch a type back to individual access, set its universal permission level to No access, then grant access to specific objects.

Remove access​

  1. Navigate to Settings > Groups and select a group.
  2. Go to the Object permissions tab and click Edit permissions.
  3. Set the object's permission level to No access. To remove access to several objects, select them, click Assign access level, and choose No access.
  4. Click Review changes, then click Confirm.

When a change lowers a group's permission level, the review screen highlights it so you can confirm the reduction.

Grant access to resources an app depends on​

When you give a group access to an app that queries resources the group can't use, Retool shows a Missing dependency access banner. Without access to those resources, people who open the app may see errors.

  1. Click View dependencies in the banner.
  2. Review the resources and the apps that depend on each one.
  3. Click the button to grant Use access to the resources.

View object permissions​

You can review a group's or user's object permissions from Settings.

  1. Navigate to Settings > Groups and select a group.
  2. Go to the Object permissions tab.

The tab lists every object the group can access, organized by type. Universal access appears as a row such as All apps. Folders list the objects they contain. The tab shows the permission level for each row and whether it's inherited from a parent folder.

  • Object permissions: Understand access levels, universal and individual access, and folder inheritance.