Comment on a page
Leave a note on a page or one of its components, reply, resolve a thread when it's dealt with, and see who is told.
How-to guide2 min read
Comments are notes for the people working on a page. Unlike the page chat, they stay with the page until someone deletes them, and each one can be about a single component.
Add a comment
- Open the page and choose Comments in the side panel's icons.
- To comment on a component, select it first, in the component list or the preview. The box then says, for example, A comment on Hero. With nothing selected, the comment is about the whole page.
- Write your comment and choose Comment, or press ⌘Enter (Ctrl+Enter).
Reply
Choose Reply under a comment, write your answer and choose Reply again, or press ⌘Enter (Ctrl+Enter). Esc cancels. Replies go under the first comment of the thread, so a thread is one level deep.
Resolve a thread
When a thread is dealt with, choose Resolve on it. It is hidden from the list, and Show resolved brings resolved threads back, with their number, such as Show resolved (3). Reopen puts a thread back on the list.
Where comments show
- The number on the Comments icon counts open threads on the page.
- A component with open comments shows a speech bubble with their number in the component list. Choose it to read them.
- With a component selected, Only this component shows just its comments.
Who is told
When you comment on the page, everyone who has commented on it before, and whoever changed the page last, gets a notification. When you reply, the others in that thread and whoever changed the page last are told. The notification links straight to the comments. You are never told about your own comments.
Comments don't mention people. To bring someone in by name, type @ and their name in the page chat; see Editing a page together. Make it a comment on a chat message turns it into a comment on the page, about the component it points at.
Who sees comments
Everyone who can open the page in the space sees its comments and can add, reply to, resolve and reopen them, including people who can only view the page. That lets reviewers leave notes on a page they can't edit. You can delete your own comments, and owners and administrators can delete any. Deleting the first comment of a thread deletes its replies too.
Comments on a review are separate and stay with the review; see Send a page for review, and approve one.
Was this page helpful?