> For the complete documentation index, see [llms.txt](https://docs.sprinto.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sprinto.com/policies/dashboard-actions/review-policies-with-comments.md).

# Review Policies with Comments

Sprinto supports a dedicated **Reviewer** role to help teams collaboratively review policy and procedure drafts. Reviewers can leave comments, suggest changes, and highlight content—without editing the document or affecting its approval state. All comments are visible only during the **Draft** stage.

***

### **Who can review a policy?**

<table><thead><tr><th width="102.8125">Role</th><th>Permissions</th></tr></thead><tbody><tr><td><strong>Reviewer</strong></td><td>Can comment on a draft, highlight content, and tag suggestions. Cannot edit or approve the policy.</td></tr><tr><td><strong>Approver</strong></td><td>Can view reviewer comments and approve the document.</td></tr><tr><td><strong>Author</strong></td><td>Can view, reply to, and resolve comments. Can send the document for approval.</td></tr></tbody></table>

{% hint style="info" %}
You can assign multiple reviewers to a single document, but only one approver.
{% endhint %}

***

### **Add comments to a document**

1. Open the policy as a reviewer.
2. Highlight any portion of the content in the left pane.
3. Click **Add comment** in the right pane.
4. Type your comment and click **Save**.

You can:

* Edit or delete your own comments
* Reply to others' comments (if you're the author or reviewer)
* View all unresolved comments in the right-hand comment thread

***

### **Resolve comments**

Authors or approvers can resolve comments during the review process.

* To resolve a comment, click the three-dot menu next to the comment and select **Delete**.
* All unresolved comments are automatically removed once the policy is approved.

{% hint style="info" %}
Due to editor limitations, resolving a comment currently deletes it. Comments are stored as in-line tags using TinyMCE spans and conversation IDs.
{% endhint %}

***

### **What happens after approval?**

Once the approver clicks **Approve**:

* The document status changes to **Active**
* All comments are cleared from the draft
* The reviewer thread is no longer accessible

This ensures that approved policies remain clean and finalised for staff and audits.

***

### **Best practices**

* Use comments to suggest changes without altering the policy directly.
* Review all feedback before sending a policy for approval.
* Let reviewers know when their feedback has been addressed.

***

### **Next steps**

Once the review is complete:

* Approvers can approve the policy and move it to **Active**
* The policy can then be acknowledged by employees
* You can version the policy later if further changes are required.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sprinto.com/policies/dashboard-actions/review-policies-with-comments.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.