Early access offer:Early access: 30% off, for as long as you stay subscribed.

Claim offer

Comment on a document and suggest changes

Leave comments on a written document, tag people with @, and suggest new words that someone who can edit accepts or rejects.

Who it’s for
Anyone who can open a document comments. People who can edit it accept suggested changes.
Plans
Every plan
Time
1 minute

Comments sit beside a document you write in SafetyDocs, so people can ask questions and give feedback without changing it. Uploaded files have comments on their own pages instead.

Add a comment

  1. Step 1: Open Comments

    Open the document and choose Comments on the right. Its number is how many comments are still open.

  2. Step 2: Pick the words it's about

    To comment on particular words, select them on the page first. They show above the comment box: choose ✕ there to leave them out. While you're reading, Comment also appears under the words you select.

  3. Step 3: Write and send

    Type in Add comment and press Enter, or choose the arrow. Shift+Enter starts a new line.

Choose a comment to open it and reply. Choose a comment about particular words to see them highlighted on the page.

Comment on a block or one item in it

While you're editing, you can pin a comment to a block, or to one item inside it.

  1. Step 1: Pick what it's about

    Select a block on the page: a heading, a paragraph, the details or the hazard table. To comment on one item in it, such as one high-risk work item, a details row or a hazard, select that item.

  2. Step 2: Choose the comment button

    It's in the bar under the block. The bar turns into a comment box, and the block's own pane stays open.

  3. Step 3: Write and send

    Type, then press Enter or choose the arrow. Esc closes the box without sending.

The comment button shows how many open comments are already on that block or item. Choose it to see the latest one and add yours, or choose View all to open Comments at that comment. In Comments, choose a comment on a block or an item to see it outlined on the page.

Tag someone

Type @ and the start of a name, then pick the person. Arrow keys and Enter work too. Their name shows highlighted in the comment. Anyone in your organisation can be tagged. Tagging doesn't email them, so tell them where to look.

Suggest a change

  1. Select the words to change on the page.
  2. In Comments, choose Suggest a change.
  3. Type what they should say instead, or leave it empty to take them out, and send.

The suggestion reads Replace: “the old words” with “the new words”.

Someone who can edit the document chooses ✓ to accept it: the words change in the draft, so publish a new version when workers should see it. ✕ rejects it, and the person who suggested it can withdraw it with ✕ too. If the words have changed since the suggestion was made, accepting it changes nothing and says so.

Note

You can suggest a change to words in one paragraph or list item of the document's text. Words inside a table, a list of hazards or the details aren't offered: comment on them instead.

Resolve and delete

Resolve a comment once it's dealt with: open its ⋮ menu and choose Resolve comment. It moves under Show resolved, where you can open it again. The person who wrote it and anyone who can edit the document can resolve it.

The person who wrote a comment or reply, the document's owner and Admins can delete it.

Was this article helpful?