Roles

Assign admin, editor, or viewer roles to manage team access and permissions.

Role-based access control (RBAC) is available on Enterprise plans.

Mintlify provides three dashboard access levels: viewer, editor, and admin.

	Viewer	Editor	Admin
View content in the editor	✅	✅	✅
View dashboard and analytics	✅	✅	✅
Make suggestions and comments in the editor	✅	✅	✅
Edit and format content in the web editor	❌	✅	✅
Upload media	❌	✅	✅
Publish changes	❌	✅	✅
Trigger deployments	❌	✅	✅
Create and delete API keys	❌	✅	✅
Configure integrations	❌	✅	✅
Configure assistant	❌	✅	✅
Configure add-ons	❌	✅	✅
Invite editors and viewers	❌	✅	✅
Update user roles	❌	❌	✅
Invite admins	❌	❌	✅
Delete users	❌	❌	✅
Manage billing	❌	❌	✅
Manage SSO	❌	❌	✅
Update custom domain	❌	❌	✅
Update Git source	❌	❌	✅
Delete organization	❌	❌	✅

Limit admin access to only the people who need to perform admin tasks.

Viewer role in the editor

Viewers can open the web editor and browse all pages but cannot directly edit content. When a viewer opens the editor, the following restrictions apply:

• Suggesting mode is always active. Viewers are automatically placed in suggesting mode and cannot switch to editing mode. Text changes appear as suggestions for editors or admins to accept or reject.
• Formatting toolbar is hidden. The text formatting options (bold, italic, underline, strikethrough, code, and links) are not available. Only the Comment button appears in the floating toolbar.
• Publish button is hidden. Viewers cannot publish changes or create pull requests.
• Media uploads are disabled. Viewers cannot upload images or videos through drag-and-drop or the slash command menu.
• Markdown mode is read-only. Viewers can view the source MDX but cannot edit it directly.

Add members to your organization

By default, the person who creates your Mintlify organization has admin access. Add additional editors in the Members page of your dashboard.

You can have as many members as you need in your organization. Seats can incur additional costs. See the pricing page for more details.