From 8f52ff6b3d4e6826a6ba5b3612d35665d1d2a6c7 Mon Sep 17 00:00:00 2001
From: "mintlify-development[bot]"
<109878554+mintlify-development[bot]@users.noreply.github.com>
Date: Tue, 17 Mar 2026 22:15:07 +0000
Subject: [PATCH] Document viewer role suggesting mode in the web editor
Viewers can now open pages in the web editor and propose changes using
suggesting mode. The editor automatically locks viewers into suggesting
mode and restricts formatting tools, media uploads, and publishing.
Generated-By: mintlify-agent
---
dashboard/permissions.mdx | 2 ++
dashboard/roles.mdx | 14 ++++++++++++++
editor/suggestions.mdx | 4 ++++
3 files changed, 20 insertions(+)
diff --git a/dashboard/permissions.mdx b/dashboard/permissions.mdx
index d3ce45429..c5857fc35 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.
+People with the viewer role can open pages in the web editor and propose changes using [suggesting mode](/editor/suggestions). Viewers cannot directly edit content, 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..7045cd84b 100644
--- a/dashboard/roles.mdx
+++ b/dashboard/roles.mdx
@@ -14,7 +14,9 @@ Mintlify provides three dashboard access levels: viewer, editor, and admin.
| ------------------------------ | :----: | :----: | :---: |
| View content in the editor | ✅ | ✅ | ✅ |
| View dashboard and analytics | ✅ | ✅ | ✅ |
+| Make suggestions in the editor | ✅ | ✅ | ✅ |
| Edit content in the web editor | ❌ | ✅ | ✅ |
+| Upload media | ❌ | ✅ | ✅ |
| Trigger deployments | ❌ | ✅ | ✅ |
| Create and delete API keys | ❌ | ✅ | ✅ |
| Configure integrations | ❌ | ✅ | ✅ |
@@ -34,6 +36,18 @@ Mintlify provides three dashboard access levels: viewer, editor, and admin.
Limit admin access to only the people who need to perform admin tasks.
+## Viewer access in the web editor
+
+Viewers can open pages in the web editor and propose changes using [suggesting mode](/editor/suggestions). The editor automatically enables suggesting mode for viewers and prevents them from switching to direct editing.
+
+Viewers cannot:
+- Use text formatting tools (bold, italic, underline, strikethrough, code, links)
+- Change content types (headings, lists, etc.)
+- Upload images or videos
+- Publish changes
+
+This makes the viewer role ideal for stakeholders, reviewers, or subject-matter experts who need to propose content changes without direct write access.
+
## 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..37f3938ae 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.
+
+ Users with the [viewer role](/dashboard/roles) are always in suggesting mode. The editor enables suggesting mode automatically for viewers and does not allow them to switch to direct editing.
+
+