Collaborate among editors

  • Updated

Most website content is produced by different editors, and on some websites, content or other changes need to be reviewed and approved before they can be published. 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 on projects, and you can also tag colleagues who are then notified of your comment.

Comments are a good way of adding information about changes you have made or asking other editors to review the item. Other editors can view your comments and reply to them, and also add their own. Email notifications may be sent out to let you know of other editors' actions.

Comments are connected to a specific version of an item. If you delete an item version, all comments on that version are also deleted.

Add comments

Comment on content items

You can add comments on any type of content item. A real-life scenario might be when you are working on an item that needs to be reviewed, and you want to let the reviewers know exactly what has been updated.

You 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.


If you are using the Content approvals feature, an administrator may also have made it mandatory to add a comment when you set an item for Ready for Review. In that case, the following dialog box is displayed when you send something for review:

Image: Comment dialog box when setting item to 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 either 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).


To tag another editor, enter @ and partial usernames and select from a results list. You can tag any of the available users but the tagged user still needs access rights to the project item to see the actual comment. Tagged users are notified in the user interface of comments.


Comment in projects

You can add comments on a project itself or on specific project items or actions.

If you go to the project overview to read a comment, the project is automatically activated. If you do not want to continue working in the project, you have to deactivate it again.

Image: Comment on project


Image: Comment on project item


Image: Reply to comment on project item


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 yellow comment icon Optimizely image.


  3. Add a comment in the comment text box. If you add a comment on a project item, you can either add it to the item itself or click Comment on one of the item's actions.
  4. To tag another user, enter @ followed by the user name. Select the user from the displayed list of suggested users. The tagged user receives a notification in the user interface, and depending on the system configuration, may also receive an email notification. You can tag any of the 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 project


    Image: Comments on project item


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 yet.