Skip to content
English
  • There are no suggestions because the search field is empty.

Create a custom role

Summary

Built-in roles can't be edited directly, but you can clone one into a custom role and define exactly what it can see and do. This step completes once anyone in your organization saves a custom role.

Before you start

You need the Manage Users or Manage Tenant permission to open People & access → Roles, and Manage Tenant to create or edit a role. The checklist offers this step to people who hold both Manage Users and Manage Tenant; anyone else sees Ask your admin on it. Available on every plan.

1. Start from an existing role

  1. Go to People & access → Roles. You'll see a full permission matrix: permissions down the side, roles across the top.
  2. Find the built-in role closest to what you need.
  3. Clone it into a new custom role: built-in roles can't be edited directly, so cloning is the starting point for any customization.

2. Adjust the permissions

  1. In the cloned role, toggle the specific permissions you want to add or remove.
  2. Name the role something that identifies its purpose.
  3. Save.

If you're editing a role that's already assigned to people, you'll be warned how many users are affected before saving: changes to an assigned role apply immediately.

Confirm it worked

The new role appears in the roles matrix, and is available to assign to a user from the Users page. Assign it to a test account (or your own, temporarily) and confirm the permissions behave as intended.

If it didn't work

  • The role has fewer permissions than you selected: Select all matching and Clear matching apply to whatever your permission search is currently filtering, not the whole list. Filtering, clicking Select all matching, then clearing the filter grants only the filtered set. Check the filter before using either button.
  • Your edits disappeared: the editor warns before closing or switching to another role with unsaved changes ("You have unsaved changes to this role. Discard them and close the editor?"). Discarding at that prompt loses them; save first.
  • A user's row shows "unknown role": this shouldn't happen, because a role that's assigned to anyone can't be deleted. Contact support.
  • Can't edit a built-in role: clone it into a custom role first.
  • A permission doesn't seem to apply: confirm you saved after toggling it; navigating away from unsaved changes on this page should warn you first.
  • Deleted a role or discarded changes by accident: both actions require confirmation before they take effect, specifically to prevent this; if you saw a confirmation dialog and proceeded, the action is final.
  • Can't reach this page at all: ask whoever administers your organization for the Manage Users or Manage Tenant permission.

Related