Pages 2.0 | Add and Manage Comments on a Page

🎯 Who this article is for: This article is for anyone with edit access to a page or page group, including admins, page group owners, page group editors, and individual page editors.

💼 Package requirements: Adding and managing comments in pages is available to all packages.

🔒 Permissions: Comments can only be added and viewed by users with edit access to the page group or page.

🚧 Beta testing: Commenting in pages is currently in Beta testing.

1. Overview

Comments in Pages 2.0 let the people who own and maintain a page leave feedback, flag questions, and coordinate changes directly on the content, pinned to the widget or page header the feedback refers to. There is no need to paste content into a separate message or describe where on the page you mean: the comment lives right there on your page. 

All open and resolved comments are collected in a sidebar organized by status, giving everyone with edit access a shared view of what has been flagged, what has been addressed, and what still needs attention.

2. Use cases

• Keep feedback in context, not in a separate thread: When multiple editors work on the same page, comments attach feedback to the exact widget it refers to. One person flags an issue directly on the content, another resolves it, and no one needs to describe where the problem is or forward a message chain to provide context.
• Coordinate cross-team updates without extra messages: A content owner reviewing a page can comment on an outdated section, @mention the editor responsible, and track resolution in the comments sidebar, all without leaving the page. When the update is done, the comment is resolved and the record is there for anyone who needs it.
• Run a structured pre-publish review: Before publishing a high-visibility page, teams can use comments to surface open questions, flag sections that need checking, and work through each one before the page goes live. The open comment count in the editor navigation bar gives a clear signal of how much is still unresolved.

3. Before you begin

Before working with comments, keep the following in mind:

• Commenting is available in the page editor only, which requires edit access to the page group or page.
• Comments can be added to widgets and page headers only. Sections do not support comments.
• When you @mention a user, only those with edit access to the page will appear as options. This is by design: only users who can open the page editor can view and act on comments.
• Comments are not affected when you publish a page. Any open comments will remain open until they are resolved or deleted.

4. How to add a comment

1. Open the page in the Pages 2.0 editor.
2. Enter commenting mode using one of two methods:
   • Via the Comments icon: Click the Comments icon (speech bubble) at the top-right of the navigation bar. The comments sidebar will open on the right, with tabs for Open and Resolved comments. Hover over a widget or page header until the blue Add comment icon appears at the top-right of it, then click it to open the comment box.
   • Via Widget comments: Hover over a widget and click the Widget comments speech bubble icon. This opens commenting mode and takes you directly to the comment box.
3. Type your comment. To add an emoji, click the emoji icon next to the send button. To mention a user, type @ and write the name of the user.
   • 🗒️ Note: Only users with edit permission to the page can be mentioned in comments.
4. Click Send comment to post. Your comment will appear in the sidebar under Open.

To close the comments sidebar, click the X at the top-right of it.

💡 Tip: Write comments that are specific and actionable. "Update this section to reflect the new policy" is easier to act on than "this needs changing."

5. How to manage comments

Reply to a comment

Click Reply under a comment to start a thread. A reply box will appear where you can write your response, @mention a user, or add an emoji, the same way you would when adding a new comment. Click Send comment to post.

🗒️ Note: Replies do not add to the open comment count. The count shown on the Comments icon reflects original comments only, not threaded replies.

Resolve and unresolve a comment

When the issue has been addressed, click the Resolve comment checkmark icon at the top-right of the comment. The comment moves to the Resolved tab in the sidebar, and the open comment count shown on the Comments icon in the navigation bar decreases by one.

To unresolve a comment, navigate to the Resolved tab in the sidebar and click the left-pointing arrow icon (Mark as unresolved) at the top-right of the comment. It will move back to the Open tab.

🗒️ Note: The open comment count reflects only the page you are currently viewing. If you navigate to a different page in the same page group, the count will update to show that page's open comments only.

Edit a comment

1. Click the three-dot menu at the top-right of the comment.
2. Select Edit.
3. Make your changes, then click Save. To discard, click Cancel.

Share a comment

Sharing a comment copies a direct link to it, which is useful when you want to point a specific editor to a piece of feedback quickly, without asking them to search through the sidebar themselves.

1. Click the three-dot menu at the top-right of the comment.
2. Select Share. The comment link is copied to your clipboard.
3. Paste and send it to any user with edit access to the page.

⚠️ Important: Comment links can only be opened by users with edit access to the page. If you send the link to someone without edit permissions, they will not be able to open the page’s editor.

Delete a comment

1. Click the three-dot menu at the top-right of the comment.
2. Select Delete.

⚠️ Important: You can only delete your own comments. Deleting a comment is permanent and cannot be undone. Only delete a comment when you are certain it is no longer needed.

6. Best practices

• Resolve before publishing key updates: If your page has open comments when you are ready to publish, work through them first. Publishing with unresolved comments is not blocked, but a clean sidebar signals that the content has been reviewed and is ready.
• Use @mentions to assign issues clearly: Rather than leaving a general comment and hoping the right person sees it, @mention the user who should address it. This makes ownership explicit and reduces the chance that feedback sits unnoticed.
• Share links for async review: When you need a specific editor to look at a comment, share the link directly rather than pointing them to the page and asking them to find it. This is especially useful on content-heavy pages with several open comments at once.

7. Frequently asked questions

Do comments appear to page viewers when they read the page?

No. Comments are only accessible within the page editor and are completely separate from the published page. Viewers accessing the page normally will not see any comments, and commenting activity does not change the published content.

Can I use comments to communicate with everyone who has access to the page?

No. Comments are only visible to users with edit access. If you want to notify all users with access to the page that something has changed, use a page notification when publishing.

🔎 Learn more in Notify Users When You Publish or Update a Page.

Can I delete another user's comment?

No. You can only delete your own comments. To address someone else's comment, you can resolve or unresolve it, but you cannot delete it.

Who gets notified when a comment is added or resolved?

A new comment sends an in-app notification to all users with edit access, but does not trigger an email. An @mention triggers both an in-app and an email notification. If a comment is deleted after you receive a notification, the notification stays in your feed, but clicking it will show nothing. No notifications are sent when a comment is resolved.