Leaving comments on documents

This page is for anyone asked to review a document in a brand portal. When a document is open for review, you can leave comments on it directly: point at the exact spot you mean, or comment on the document as a whole. The team that shared it sees your comments and can reply in the same place.

Before you start

• Sign in with your own username and password. Comments are attributed to you by name, so they need your own sign-in. If you don’t see any comment controls, you may be on a shared login or a public page; ask whoever sent you the link.
• Only some documents take comments. The team turns comments on for each document they want reviewed.
• Use a laptop or desktop to place pins. On a phone you can read and reply to comments, but not point at a new spot.

Opening a document

Click a document on the page to open it full-screen. The comments panel sits on the right. Its speech-bubble button in the top bar shows or hides it.

The document opens in browse mode, so links, tabs and menus in it work as usual.

Commenting on a spot

1. Click Comment mode in the top bar (the speech bubble with a plus), or press C.
2. Move your pointer over the document. Whatever you’re about to comment on is outlined.
3. Click it. A numbered pin drops where you clicked, and a comment box opens beside it.
4. Type your comment and click Comment.

In comment mode, clicking places a pin instead of pressing a button or following a link. Press C again, or click the button again, to go back to browsing.

In a PDF, click any point on a page to pin a comment there.

Commenting on the whole document

For overall feedback that isn’t about one spot, type in the box at the bottom of the comments panel and click Comment.

Replying, editing and resolving

• Click a comment in the panel to jump to its pin. The numbers in the panel match the pins in the document.
• Reply in the box under any open comment.
• Edit or delete your own comments with the icons beside them.
• Resolve a comment you started once it’s been dealt with; it collapses to one line. Click it to read it again, and Reopen it if it wasn’t actually fixed.

Replies marked Editor come from the team that runs the portal. You only see comments from your own group of reviewers and from that team; other groups’ comments aren’t shown to you, and yours aren’t shown to them.

What the labels mean

• A monitor, tablet or phone icon beside a comment’s number: the screen width the comment was made at. Hover it to see the width, such as Mobile · 390px. Some documents have Desktop, Tablet and Mobile buttons in the top bar to view the page at those widths, and clicking the icon switches to it.
• Not visible in this state: what the comment points at is hidden right now, for example inside a closed menu or a tab you haven’t opened.
• Outdated: the document has been revised and what the comment pointed at is no longer there. The comment is kept so you can still read it.
• From an earlier version: the comment was made on a previous version of the document.

Seeing all your comments

The Comments icon at the bottom of the sidebar lists every comment you can see, grouped by document. The badge on it counts the open ones. Comments with activity since you last looked are marked New. Click one to go straight to it in its document.

New comments from others show up when you open a document or the Comments list, or when you come back to the browser tab.