--- title: Collaborate with comments slug: cms-12/docs/collaborate-with-comments docTags: createdAt: 2026-08-10T15:56:03.000Z --- Different editors produce most website content; on some websites, content or other changes need to be reviewed and approved before publication. To facilitate collaboration among editors when creating content and among editors and reviewers when approving changes, Optimizely Content Management System (CMS) comes with a commenting functionality. You can add comments on content items and projects and tag colleagues, who are notified of your comments. Comments are a good way to add information about changes you have made or ask other editors to review the item. Other editors can view your comments, reply to them, and add their own. Email notifications may be sent to inform you of other editors' actions. :::hint{type="info"} **Note** Comments are connected to a specific version of an item. If you delete an item version, comments on that version are also deleted. ::: ## Add comments ### Comment on content items You can add comments on any content item. A real-life scenario might be when you are working on an item that needs to be reviewed and want to let the reviewers know exactly what is updated. You can add and view comments in the comment panel. It is opened and closed by clicking the comment symbol in the top toolbar. The icon is black when the comments panel is hidden and blue when it is visible. ![add and view comments in the comment panel.](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/dWnKpf3JHNh-bfBDWekgD-20260720-145553.png) If you use the [Content Approvals](docId\:FJT9V4MfH6aJdlcxjWAxh) feature, an administrator may also have made it mandatory to add a comment when you set an item for **Ready for Review**. To add a comment to a content item, open the content item. You need access rights to the item to view and post comments. The following image shows your commenting options. Click the comment icon (1) to open the comment panel. You can add a comment in the top comment text box (2) and click **Post** to add a comment (3), or click **Comment** (5) on one of the item's actions to add a comment (4). ![open the comment panel.](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/s3HAuDyJ6KhkDwfh0Hi8o-20260720-145554.png) Enter **@** and partial usernames to tag another editor and select from a results list. You can tag any available users, but the tagged user still needs access rights to the project item to see the actual comment. Tagged users are notified of comments in the user interface. ![Tagged users are notified of comments in the user interface](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/bp7bSDOj4aud16GK0wxNv-20260720-145553.png) ### Comment in projects You can comment on a project or specific project items or actions. :::hint{type="info"} **Note** The project is automatically activated if you go to the project overview to read a comment. If you do not want to continue working on the project, you have to deactivate it again. ::: Image: Comment on the project ![Comment on the project](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/K4sFsyo0uEHszRch4sCzI-20260720-145553.png) Image: Comment on the project item ![Comment on the project item](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/hAnsirf-5BlWpdcrqkhZg-20260720-145553.png) Image: Reply to comment on the project item ![Reply to comment on the project item](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/8_1PF-kfgk_LjPOqKs-by-20260720-145554.png) **Add a comment to a project or project item** 1. Select the project in the project toolbar and click **Overview**. 2. To add a comment to a: - **Project**. Select the **Project Comments** tab in the project overview. - **Project item**. Select the **Items** tab in the project overview and then **Show comments**. Select the project item you want to comment on. Items that already have comments are marked with a comment icon. ![add a comment on a project item](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/06_ync6sanWFpElVRdLFG-20260720-145553.png) 3. **Add** a comment in the comment text box. If you comment on a project item, you can add to it or click **Comment** on one of the item's actions. 4. Enter **@** followed by the user name to tag another user. Select the user from the displayed list of suggested users. The tagged user receives a notification in the user interface and may also receive an email notification depending on the system configuration. You can tag any available users, but the tagged user still needs access rights to the project item to see the actual comment. 5. Press Enter or click **Post**. Image: Comment on the project ![Comment on the project](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/6eKimi_y9hzBxwZmNttL1-20260720-145553.png) :::Paragraph{indent="1"} Image: Comments on the project item ::: ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/xLzyN_Dv5OYNZCZAsbAzP-20260720-145554.png" size="100" alt="Comments on the project item" isUploading="false" showCaption="false" indent="2"} ## Reply to a comment Click **Reply** on the comment you want to reply to and enter your comment in the text box. Press Enter or click **Post**. ## Edit a comment or reply You can edit comments and replies that you have created yourself. Click **Edit** on the comment or reply you want to change. Press Enter or click **Save**. Edited comments or replies are marked with a pen icon. ## Delete a comment or reply You cannot delete comments or replies.