Skip to main content
Role-based access control (RBAC) is available on Enterprise plans.
Mintlify provides three dashboard access levels: viewer, editor, and admin. Without RBAC, every member has full access to your organization’s dashboard, and new members join as editors. To invite members, change their roles, transfer ownership, or remove them, see Members.
If the Role dropdown on your Members page offers Publisher, your organization uses expanded roles instead.
* If your project requires review before publishing, editors request a review instead of publishing to the deployment branch, and an admin publishes the approved changes. Only admins can merge pull requests into the deployment branch from the editor.
Limit admin access to only the people who need to perform admin tasks.

​
Expanded roles

Organizations with expanded roles have six roles: owner, admin, publisher, editor, commenter, and viewer. You can only invite members or assign roles up to your own role.
  • Owner: Everything an admin can do, plus deleting the project, deleting the organization, and transferring ownership. Every organization has one owner.
  • Admin: Full control over content, members, roles, and settings, including billing and the custom domain. Admins can publish without review.
  • Publisher: Everything an editor can do, plus publishing changes and approving review requests.
  • Editor: Create and edit content, comment, request reviews, and manage site and workspace settings, integrations, API keys, and the assistant. Editors can’t publish or approve reviews.
  • Commenter: Everything a viewer can do, plus commenting on pages.
  • Viewer: View content and preview unpublished edits.

​
Custom roles

If none of the built-in roles are sufficient for your team, create a custom role with the exact permissions a member needs. Custom roles are available to organizations with expanded roles. Owners and admins can manage custom roles in the Custom roles section on the Members page.

​
Create a custom role

  1. Navigate to the Members page of your dashboard.
  2. In the Custom roles section, click New custom role.
  3. Enter a Label, which appears in role menus, and an optional description.
  4. Select permissions, or select Grant all permissions.
  5. Click Create role.
Permissions come in three groups:
  • Content: Pages has read and write access. Comments and Publishing and reviews have write access only. Both require Pages read access.
  • Project: View or manage access to project settings, such as Domain setup, Site, Editor, Git, and Assistant.
  • Organization: View or manage access to organization settings, such as Members, Security, Billing, and API keys.
You can only grant permissions you have yourself. Permissions that only the owner has, such as deleting the organization or transferring ownership, aren’t available for custom roles. Every custom role can view the organization, the project, its publish history, and its members. To change a custom role, open its actions menu in the Custom roles section and select Manage role.

​
Repository contributors and deployments

Anyone with write access to your documentation repository can contribute by pushing changes. Pushes to your deploy branch deploy automatically, whatever the person’s dashboard role. Dashboard roles only control what people can do in the Mintlify dashboard.