Roles

Assign admin, editor, or viewer roles to team members to control access levels, editing permissions, and deployment capabilities in Mintlify.

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	✅	✅	✅
Ask the Slack agent questions	✅	✅	✅
Make changes with the Slack agent	❌	✅	✅
Edit content in the web editor	❌	✅	✅
Publish changes	❌	✅	✅
Create, rename, and delete pages	❌	✅	✅
Reorder navigation	❌	✅	✅
Upload media	❌	✅	✅
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.

Add members to your organization

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

You can invite any number of members to your organization.

Accept an invitation

If you were invited to an existing Mintlify organization, follow these steps to join it.

1. Sign up or sign in with the invited email.

   Open the invitation email and use the link to reach the dashboard. Create your Mintlify account (or sign in) with the same email address the invitation was sent to. If the emails don’t match, the invitation won’t be linked to your account.

   If you’re already signed in to a different Mintlify account in your browser, open the invitation link in a private or incognito window to avoid a session conflict.

2. Accept the invitation.

   Once you’re signed in, go to your dashboard and click Accept organization invitations. After accepting, you’re a member of the inviting organization.

3. Switch between organizations.

   If you also belong to your own organization, use the Switch organization option in the profile dropdown (top right of the dashboard) to move between the organization you joined and any others you belong to.

If you don’t see the Accept organization invitations button after signing in with the invited email, ask an admin of the inviting organization to re-send the invitation from their Members page.

Change the email on your account

Mintlify accounts are tied to an email address. To move your membership to a different email, use the invite flow to add the new address and remove the old one:

1. Invite the new email.

   From the Members page, invite your new email address to the organization. Assign it the same role as your current account.

2. Accept the invitation with the new email.

   Sign in with the new email address and follow the Accept an invitation steps to join the organization.

3. Remove the old account.

   From the Members page, remove the account associated with your old email address.

Only admins can invite or remove members. If you’re not an admin, ask an admin in your organization to perform these steps for you.