From 985f4bacb71a68d4c57f845bef43dad021ce1c20 Mon Sep 17 00:00:00 2001
From: "mintlify-development[bot]"
<109878554+mintlify-development[bot]@users.noreply.github.com>
Date: Tue, 17 Mar 2026 21:27:25 +0000
Subject: [PATCH] Clarify viewer role access in the web editor
Generated-By: mintlify-agent
---
dashboard/permissions.mdx | 2 ++
dashboard/roles.mdx | 56 ++++++++++++++++++++++++++-------------
editor/suggestions.mdx | 4 +++
3 files changed, 43 insertions(+), 19 deletions(-)
diff --git a/dashboard/permissions.mdx b/dashboard/permissions.mdx
index d3ce45429..8a24255c2 100644
--- a/dashboard/permissions.mdx
+++ b/dashboard/permissions.mdx
@@ -6,4 +6,6 @@ keywords: ["editor access", "permissions", "team", "seats", "deployment"]
People with the editor or admin [role](/dashboard/roles) can use the web editor, trigger deployments, and manage integrations from your dashboard. When an editor or admin publishes through the web editor or merges a pull request into your documentation repository, the changes deploy to your live site automatically.
+[Viewers](/dashboard/roles#viewer-access-in-the-web-editor) can open the web editor to browse content and make suggestions, but they cannot edit content directly, upload media, or publish changes.
+
Anyone with access to your documentation repository can contribute to your documentation by pushing changes to the repository, but their changes do not deploy until an editor or admin manually triggers a deployment from your dashboard.
diff --git a/dashboard/roles.mdx b/dashboard/roles.mdx
index e8850e7f2..36044744d 100644
--- a/dashboard/roles.mdx
+++ b/dashboard/roles.mdx
@@ -10,30 +10,48 @@ keywords: ["RBAC", "role-based access control", "admin", "editor", "viewer", "pe
Mintlify provides three dashboard access levels: viewer, editor, and admin.
-| | Viewer | Editor | Admin |
-| ------------------------------ | :----: | :----: | :---: |
-| View content in the editor | ✅ | ✅ | ✅ |
-| View dashboard and analytics | ✅ | ✅ | ✅ |
-| Edit content in the web editor | ❌ | ✅ | ✅ |
-| 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 | ❌ | ❌ | ✅ |
+| | Viewer | Editor | Admin |
+| ---------------------------------------- | :----: | :----: | :---: |
+| View content in the editor | ✅ | ✅ | ✅ |
+| View dashboard and analytics | ✅ | ✅ | ✅ |
+| Add comments and suggestions | ✅ | ✅ | ✅ |
+| Edit 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 access in the web editor
+
+Viewers can open the web editor to browse content and participate in collaboration. When a viewer opens the editor, they are automatically placed in [suggesting mode](/editor/suggestions) and cannot switch to direct editing.
+
+In suggesting mode, viewers can:
+- Browse and read all pages
+- Make text suggestions that editors and admins can accept or reject
+- Leave [comments](/editor/comments) and reply to existing threads
+
+Viewers cannot:
+- Edit content directly
+- Upload images or videos
+- Publish changes or create pull requests
+- Toggle off suggesting mode
+
## Add members to your organization
By default, the person who creates your Mintlify organization has admin access. Add additional editors in the [Members](https://dashboard.mintlify.com/settings/organization/members) page of your dashboard.
diff --git a/editor/suggestions.mdx b/editor/suggestions.mdx
index 705f37b33..0242ec751 100644
--- a/editor/suggestions.mdx
+++ b/editor/suggestions.mdx
@@ -19,6 +19,10 @@ While suggesting mode is active, the **Suggesting** indicator appears in the edi
To exit suggesting mode, click the **Suggesting** indicator.
+
+ [Viewers](/dashboard/roles#viewer-access-in-the-web-editor) are automatically placed in suggesting mode when they open the editor and cannot switch to direct editing.
+
+