# Roles

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

:::callout{intent="info"}
Role-based access control (RBAC) is available on [Pro and Enterprise plans](https://mintlify.com/pricing?ref=rbac).
:::

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](/guides/agent-slack) 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                                                   |    ❌   |    ✅   |   ✅   |
| Roll back and promote 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                                                     |    ❌   |    ❌   |   ✅   |
| Change [agent publishing setting](/guides/ai-mintlify-mcp#publishing) |    ❌   |    ❌   |   ✅   |
| Delete organization                                                   |    ❌   |    ❌   |   ✅   |

:::callout{intent="tip"}
Limit admin access to only the people who need to perform admin tasks.
:::

## Repository contributors and deployments

Anyone with access to your documentation repository can contribute by pushing changes. However, their changes do not deploy until an editor or admin manually triggers a deployment from your dashboard.

## Add members to your organization

By default, the person who creates your Mintlify organization has admin access. Add additional members from the [Members](https://app.mintlify.com/settings/organization/members) page of your dashboard.

You can invite any number of members to your organization. Editors and admins can invite editors and viewers. Only admins can invite other admins.

:::callout{intent="note"}
If you have a Pro or Enterprise plan, you can upload a CSV with emails to invite members in bulk.
:::

1. Navigate to the [Members](https://app.mintlify.com/settings/organization/members) page of your dashboard.
2. Click **Invite members**.
3. Enter email addresses in the input field, or paste a list separated by commas, semicolons, spaces, or new lines. You can invite up to 250 addresses at a time. Pro and Enterprise plans can upload a CSV of emails.
4. Click **Continue** to review the invitees.
5. On the review step, assign a role to each invitee. To change several rows at once, select them and use the bulk role bar.
6. Click **Send invites**.

Mintlify flags and skips inviting any invalid addresses, duplicates, or people who are already members of your organization.

## Change a member's role

Admins can change the role assigned to any member.

1. Navigate to the [Members](https://app.mintlify.com/settings/organization/members) page of your dashboard.
2. In the member's row, select a new role from the role dropdown.
3. Confirm the change.

The new role takes effect the next time the member loads the dashboard.

## Remove a member

Admins can remove a member from the organization entirely, which deletes their access and any keys they created.

1. Navigate to the [Members](https://app.mintlify.com/settings/organization/members) page of your dashboard.
2. In the member's row, click the :icon[trash]{icon="trash"} **Remove** button.
3. Confirm the removal.

Removing a member deletes the member from your organization. Revoking a member's credentials signs them out and clears their keys, but keeps their membership.

## Revoke a member's credentials

Admins can sign a member out of the dashboard and revoke their keys and tokens without removing them from the organization. Use credential revocation when offboarding someone or responding to a compromised account.

1. Navigate to the [Members](https://app.mintlify.com/settings/organization/members) page of your dashboard.
2. In the member's row, click the :icon[shield-off]{icon="shield-off"} **Revoke credentials** button.
3. Select which credentials to revoke.
4. Click **Revoke**.

You can revoke any combination of the following credentials:

| Credential         | What revoking it does                                       |
| ------------------ | ----------------------------------------------------------- |
| Sessions           | Signs the member out of the dashboard.                      |
| CLI tokens         | Signs the member out of the [CLI](/guides/cli-install).     |
| API keys           | Deletes the API keys that the member created.               |
| Discovery API keys | Deletes the discovery API keys that the member created.     |
| M2M clients        | Revokes the member's machine-to-machine client credentials. |
| Connected apps     | Disconnects the apps the member authorized through OAuth.   |

Revoking credentials cannot be undone. The member can sign in again and create new keys and tokens unless you also remove them from the organization or block their sign-in method. You cannot revoke your own credentials.

## Related topics

- [SCIM user provisioning](/docs/dashboard/scim.md)
- [Single sign-on (SSO)](/docs/dashboard/sso.md)
- [Add the agent to Slack](/docs/agent/slack.md)

## Related pages

- [Ai](./ai-index.md)
- [Analytics overview](./analytics-index.md)
- [Api](./api-index.md)
- [Api playground](./api-playground-index.md)
- [Assistant](./assistant-index.md)
- [Automations overview](./automations-index.md)
- [Components overview](./components-index.md)
- [Create](./create-index.md)
- [Customize](./customize-index.md)
- [Dashboard](./dashboard-index.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.
