From 63dbb48aa6e4bf1ca84ca6fdf7bd9eb2b4f70136 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 2 Nov 2026 15:14:57 +0000 Subject: [PATCH 1/3] docs: point to the role permissions table in Members settings --- dashboard/roles.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/dashboard/roles.mdx b/dashboard/roles.mdx index 08953b04cd..a279b21a2f 100644 --- a/dashboard/roles.mdx +++ b/dashboard/roles.mdx @@ -49,6 +49,8 @@ Mintlify provides three dashboard access levels: viewer, editor, and admin. With Limit admin access to only the people who need to perform admin tasks. +On Enterprise plans, you can also see what each role can do in the **Role permissions** section of the [Members](https://app.mintlify.com/settings/organization/members) page of your dashboard. + ## 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. From fc9319560124e26fd123f8ebccf2740b8652293f Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 2 Nov 2026 23:39:55 +0000 Subject: [PATCH 2/3] docs: note editors become publishers and each org has one owner --- dashboard/roles.mdx | 2 ++ mint-instructions/access/team.mdx | 2 +- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/dashboard/roles.mdx b/dashboard/roles.mdx index 0249b3c5d4..975188f316 100644 --- a/dashboard/roles.mdx +++ b/dashboard/roles.mdx @@ -55,6 +55,8 @@ On Enterprise plans, you can also see what each role can do in the **Role permis If the role picker on your **Members** page offers **Publisher** and **Commenter**, your organization uses six roles instead of three: owner, admin, publisher, editor, commenter, and viewer. The **Role permissions** section shows a column for each. +When your organization switches to expanded roles, existing editors become publishers so they can still publish. Members whose role comes from your identity provider keep their assigned role. Each organization has one owner. + - **Owner**: Everything an admin can do, plus deleting the project and deleting the organization. - **Admin**: Full control over content, members, roles, and settings, including billing. - **Publisher**: Create, edit, and publish content, and approve reviews. Can't manage members, billing, or settings. diff --git a/mint-instructions/access/team.mdx b/mint-instructions/access/team.mdx index 453c9f8c3d..3609444697 100644 --- a/mint-instructions/access/team.mdx +++ b/mint-instructions/access/team.mdx @@ -18,7 +18,7 @@ Use this to add teammates, set roles, SSO, SCIM, session or IP policies, audit l - Viewer: view editor content, dashboard and analytics, ask the Slack agent questions, comment. Always in suggesting mode in the editor; cannot accept suggestions. - Editor: everything a viewer can, plus edit in the web editor, publish, create/rename/delete pages, reorder navigation, upload media, trigger, roll back and promote deployments, create/delete API keys, configure integrations, assistant and add-ons, make changes with the Slack agent, accept or reject suggestions, invite editors and viewers. - Admin: everything, plus update roles, invite admins, delete users, billing, SSO, SCIM, IP allowlist and session lifetimes, audit logs, security contact, custom domain, Git source, custom subpath, delete a project, agent publishing setting, delete organization, delete any comment. - - Expanded roles: if the **Members** role picker offers **Publisher** and **Commenter**, the org has six roles. Commenter: view and comment. Editor: create, edit, reorganize, and delete pages, and request review. Cannot publish or approve reviews. Publisher: editor plus publish and approve reviews. Admin: members, roles, settings, billing. Owner: admin plus delete the project and the organization. Members can only invite or assign roles up to their own. **Role permissions** on the **Members** page (Enterprise) shows each role's permissions. + - Expanded roles: if the **Members** role picker offers **Publisher** and **Commenter**, the org has six roles. On the switch, existing editors became publishers (IdP-managed roles unchanged), and each org has one owner. Commenter: view and comment. Editor: create, edit, reorganize, and delete pages, and request review. Cannot publish or approve reviews. Publisher: editor plus publish and approve reviews. Admin: members, roles, settings, billing. Owner: admin plus delete the project and the organization. Members can only invite or assign roles up to their own. **Role permissions** on the **Members** page (Enterprise) shows each role's permissions. - Change a role: **Members** page, **Role** dropdown (saves immediately, applies on next dashboard load). You cannot change your own role or the owner's. **Managed by SSO** rows change in the IdP. 4. Offboard: **Members** page, actions menu. **Remove member** deletes membership, access and their keys. **Revoke credentials** keeps membership and revokes any of: Sessions, CLI tokens, API keys, Discovery API keys, M2M clients, Connected apps. Not reversible; you cannot revoke your own. With expanded roles, you cannot remove the owner or revoke their credentials. 5. SSO (Enterprise, admin): **Security** page (https://app.mintlify.com/settings/organization/access), **Configure**, pick **Okta SAML** or **Microsoft Entra ID SAML**, copy **ACS URL** and **Audience URI** into the IdP, paste the IdP metadata URL back, **Save changes**. Google Workspace SAML, Okta OIDC and other providers: contact support@mintlify.com. From 94a6f3978a6a51610f20978ae69591a91b49a8e4 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 5 Nov 2026 23:20:40 +0000 Subject: [PATCH 3/3] docs: restore the three-role and credentials table headers --- dashboard/roles.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/dashboard/roles.mdx b/dashboard/roles.mdx index 21a6a7204c..c251931f8d 100644 --- a/dashboard/roles.mdx +++ b/dashboard/roles.mdx @@ -11,8 +11,8 @@ boost: 3 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. -| | Viewer | Commenter | Editor | Admin | -| ------------------------------ | :----: | :-------: | :----: | :---: | +| | Viewer | Editor | Admin | +| ------------------------------ | :----: | :----: | :---: | | View content in the editor | ✅ | ✅ | ✅ | | View dashboard and analytics | ✅ | ✅ | ✅ | | Ask the [Slack agent](/agent/slack) questions | ✅ | ✅ | ✅ | @@ -152,7 +152,7 @@ Admins can sign a member out of the dashboard and revoke their keys and tokens w 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](/cli/install). | | API keys | Deletes the API keys that the member created. |