---
title: Suggest Changes
slug: docs/suggest-changes
docTags:
createdAt: 2025-11-06T17:53:19.141Z
---
*Collect feedback and improve your documentation easily with reader suggestions.*
***
The **Suggest Changes** feature allows readers to propose edits or improvements directly within your published documentation. This makes it easy to keep content accurate, up to date, and engaging for your audience.
## Enabling Suggest Changes
To turn on this feature in your portal:
:::::WorkflowBlock
:::WorkflowBlockItem
Open your **Space Dashboard**.
:::
:::WorkflowBlockItem
Navigate to **Appearance **tab and scroll all the way down to** Portal Interaction**.
:::
::::WorkflowBlockItem
Click on **Suggest Changes** to enable it.
:::hint{type="info"}
Don't forget to **Publish** your documentation to make the feature available to readers.
:::
::::
:::::
## How Readers can Suggest Changes
Once enabled, on each document will be displayed a **Suggest Changes** button. Readers can follow these steps to submit a suggestion:
::::WorkflowBlock
:::WorkflowBlockItem
### Suggest Changes Button
Click the **Suggest Changes** button on the document.
:::
:::WorkflowBlockItem
### Edit the Content
Write new text, update existing content, or remove anything unnecessary.
:::
:::WorkflowBlockItem
### Email and Message
**Enter your email address** for confirmation and **add a brief note** explaining your suggestion.
:::
:::WorkflowBlockItem
### Send and Confirm
Click **Send for Review** and...
::Image[****]{src="https://app.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/HjY-KzEQ_sJGXaz2C_xfP-20251106-200238.png" size="60" width="810" height="250" position="center" darkWidth="810" darkHeight="250" showCaption="false"}
... confirm your submission via the email link.
::Image[]{src="https://app.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/owgjx2VyASLVSdnIHxkNV-20251106-200402.png" size="80" width="1073" height="575" position="center" darkWidth="1073" darkHeight="575" showCaption="false"}
:::
::::
## Managing Suggestions (for portal owners)
::::::WorkflowBlock
:::::WorkflowBlockItem
### Notification of Suggested Document Changes
When a suggestion is submitted, you will receive a **notification **and an **email** to inform you.
::::VerticalSplit{layout="middle"}
:::VerticalSplitItem
:::
:::VerticalSplitItem
::Image[]{src="https://app.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/7B_mm1O27P1erLUu5QAKo-20251106-200703.png" size="88" width="639" height="362" position="center" darkWidth="639" darkHeight="362" showCaption="false"}
:::
::::
:::::
:::WorkflowBlockItem
### Navigate to Suggestion
A **comment** appears inside the document with the proposed changes.
::Image[]{src="https://app.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/6Pz1eYik4uyYbLXRdnCQi-20251106-200930.png" size="60" width="920" height="666" position="center" darkWidth="920" darkHeight="666" showCaption="false"}
:::
:::WorkflowBlockItem
### Manage the Suggestion
Click **View Suggestion** to see a document with changes on it — **removed text** in **red** and **added text** in **green**.
Then, you can:
- :FontAwesome[]{icon="fa-solid fa-check"} **Accept** **suggestion **and to apply the changes immediately.
- :FontAwesome[]{icon="fa-solid fa-xmark"} **Drop Suggestion** if you prefer to keep the current version.
::Image[]{src="https://app.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/qntiqg-N3-eUD13fcoblf-20251106-201109.png" size="70" width="1710" height="730" position="center" darkWidth="1710" darkHeight="730" showCaption="false"}
:::
::::::
:::hint{type="warning"}
⚠️ When you accept the suggestion, the document will be updated with the new one. For more complicated or multiple suggestions, we recommend to just update the file yourself.
:::
## Benefits of using Suggest Changes
The **Suggest Changes** feature promotes collaboration between readers and authors. It provides a simple, structured way to collect feedback, implement improvements, and maintain accurate, evolving documentation.
***
## Tell us what you think
We're trying to build something great, but **we need your unique perspective** to make it even better. Don't hold back and let us know what's on your mind.
::::VerticalSplit{layout="middle"}
:::VerticalSplitItem
**Feedback Form**
Need to share your thoughts directly? Use the feedback form to leave a quick text feedback.
:::
:::VerticalSplitItem
:::
::::
::::VerticalSplit{layout="middle"}
:::VerticalSplitItem
**Ask a Question (Q\&A Section)**
Have a specific problem or need a solution? Post it here! Below is a **public section** where **our community**, **our team**, or our AI can respond and offer help.
:::
:::VerticalSplitItem
:::
::::
::::VerticalSplit{layout="middle"}
:::VerticalSplitItem
**Support Chat**
Need personalized support right now? Use the **blue chat bubble** in the bottom-right corner. This connects you immediately with our support team.
:::
:::VerticalSplitItem
:::
::::