Skip to content

Collect feedback from reviewers

This tutorial walks you through creating a Create a review session, inviting a subject matter expert, and seeing how they leave inline comments and approve topics. Reviewers do not need a Topicary account.

What you will build

A review session for a three-topic Create and organize a map. You will invite a reviewer by email, walk through the review experience, and manage the feedback.

Before you begin

  • You need a map with at least two or 3 topics. If you completed the previous tutorials, use the map you already built. Otherwise, Create and organize a map with a few topics.

Monitor search analytics like search tracking and page feedback are available on every Plans and limits, including Free. Review sessions are part of the Team plan.

Review sessions are part of the Team plan. During the beta they are available to every project; after the beta, this workflow needs a project on the Team plan or higher.

Create a review session

  1. Open your map in the map editor.

  2. Scroll down to the Reviews section.

  3. Click Create review.

  4. Add a reviewer: enter their name and email address.

  5. Set a due date (optional): pick a date about a week out.

  6. Add a message to reviewers (optional): "Please review the setup and configuration sections. Focus on technical accuracy."

  7. Click Create and send invites. If you add no reviewers, the button reads Create review link and you share the link yourself.

Reviewers you added by email receive an invitation with a link to the review. On the session card, a Copy review link icon copies the URL so you can share it manually.

Use the Copy review link icon to share the review URL directly through Slack, email, or any channel. The token-based link grants access without requiring a Topicary account.

The reviewer experience

When the reviewer opens the link (no login required):

  1. They see the map's topics in a sidebar.

  2. They click a topic to read it.

  3. To leave feedback, they select text in the content. A floating Comment button appears.

  4. They click it, type their feedback, and submit.

  5. The comment anchors to the selected text with a blue highlight.

  6. At the bottom of each topic, they click Approve or Request Changes.

Reviewers can also reply to existing comments for back-and-forth discussion.

Monitor review progress

Back in the map editor's Reviews section:

  1. Assignee pills show each reviewer's status:

    • Gray = pending (has not opened the link)

    • Yellow = viewed (opened but not finished)

    • Green = completed (clicked Finish review)

  2. Comment count badges show the number of comments left for each topic.

  3. Click a reviewer's name to see their per-topic status.

Act on feedback

  1. Open a topic in the editor.

  2. Review the comments. They appear anchored to the text passages the reviewer highlighted.

  3. Make edits based on the feedback.

  4. If the reviewer requested changes, revise the section and consider sending them the link again for a second pass.

Clean up

  • Review sessions expire after 30 days. Expired sessions show an "Expired" badge and the copy-link button hides.

  • Delete a session to remove it and all its comments.

Deleting a review session permanently removes its comments, reviewer assignments, and sign-off decisions. Make sure you have addressed or documented all feedback before deleting: this cannot be undone. Only a project admin or owner can delete a review session.

What you learned

  • Review sessions let subject matter experts review content without creating a Topicary account

  • Reviewers leave inline comments anchored to specific text

  • Each topic can be independently approved or flagged for changes

  • Assignee status pills track who has reviewed and who has not

  • Sessions expire after 30 days

You have now completed all five tutorials. You know how to write, organize, reuse, Publish a web site for multiple audiences, and collect feedback. Explore the how-to guides for deeper coverage of each feature.

See also

Was this page helpful?