Roles
A role bundles permissions and the organizations or environments they apply to. People receive a role's grants while they hold it, and access tokens can carry roles their owner holds. Administrators use this tab to create and change roles and to see who holds them.
Open it from Administration → Organizations → Roles in the sidebar.

Counts and Filters
All roles
Enabled roles in this tenant.
Custom roles
Roles created or synchronized by your organization.
Supplied roles
Roles that come with IZ Suite. They are read-only; clone one to customize it.
Hold access-admin permissions
How many people and tokens can administer access itself. Click to see who.
Filter with Status (All, Custom, Supplied) and Search roles. Saved filters, Save filters, Refresh, Columns and Export work as on other lists. Export roles on this page downloads the roles on the current page.
Role Directory
Role
The role name and when it was last updated.
Type
Custom, Supplied, or Synced from a team sync source.
People
How many people hold the role.
Recorded grants
How many permission grants the role has, across its scopes.
Manage
Row actions, below.
Manage role
Opens the role drawer.
Permission matrix
Opens the role's permission matrix. See Permission Matrix below.
Assign people
Gives the role to people. See Assign People below. Not offered for synced roles.
Clone role
Creates a copy with a New role name. The copy gets exactly the same permissions in the same organizations and environments, and no members.
Delete role
Deletes a custom role. See Delete a Role below.
Assign people, Clone role and Delete role are under More actions (...).
Role Drawer

The drawer shows Type, People holding this role, Recorded grants and Last updated, a Rename role button for custom roles, and the people who hold the role. Open a person to change their roles. Supplied roles say Supplied roles are read-only. Clone this role to customize it.; synced roles say they are managed by their team sync and that local changes would be overridden.
Create a Role
Click Create role.
Enter the Role name.
Under What can they do?, tick the permissions the role needs. Use Search permissions or categories to find them.
When a permission applies per organization or per environment, click Next: where it applies.
Under Where does it apply?, tick the organizations or environments.
Click Create role.
Role name
Required. Use a name that describes the job, for example "Release approver".
What can they do?
The permissions, grouped by product area. Select at least one permission.
Where does it apply?
Organizations for organization-scoped permissions, environments for environment-scoped permissions. Choosing an environment also grants organization-scoped permissions in its organization. Tenant-wide permissions need no scope.
Assign People
Click Assign people on the role's row.
Choose the assignment method:
Choose people: pick People to assign. Only enabled people are listed.
Everyone in another role: under Give this role to everyone who holds, pick a role. This is a one-time copy of that role's current members; people who receive that role later are not added.
Click Assign role.
People who already held the role are unchanged, and their other roles are kept.
Permission Matrix
Permission matrix opens the role on its own page with a Role summary (Role type, Recorded grants, Scopes, People holding this role, Last updated) and a matrix of permissions against scopes. Granted marks each scope a permission is recorded in.
Filter by Category and scope, or search.
Click Add permissions to add permissions and scopes.
Click Export all grants to download every grant.
Click Back to roles to return to the list.
Delete a Role
Click Delete role on the row (under More actions).
Type the exact role name to confirm.
Click Delete role.
Next Steps
Users: give roles to people and add direct permissions.
Access Tokens: tokens carry a subset of their owner's roles.
Setup: create ready-made roles for pipelines and AI assistants.
Last updated
Was this helpful?

