Skip to content

Collect feedback from reviewers

By the end of this tutorial, you'll create a Create a review session, invite a subject matter expert, and see how they leave inline comments and approve topics — all without needing a Topicary account.

What you'll build

A review session for a three-topic Create and organize a map. You'll 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 three topics. If you completed the previous tutorials, use the map you already built. Otherwise, Create and organize a map with a few topics.

Review sessions are available on all plans, including Free. However, Monitor search analytics like search tracking and page feedback require a Team or Business Plans and limits.

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 — pick a date about a week out.

  6. Add a personal message: "Please review the setup and configuration sections. Focus on technical accuracy."

  7. Click Create & Send Invites.

The reviewer receives an email invitation with a link to the review. You also see a Copy Link button to share the URL manually.

You can also click Copy Link to share the review URL directly via 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 (hasn't opened the link)

    • Yellow = viewed (opened but not finished)

    • Green = completed (approved or requested changes on all topics)

  2. Comment count badges show the number of comments left per 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 all comments. Make sure you've addressed or documented all feedback before deleting — there is no way to recover deleted comments.

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 hasn't

  • Sessions expire after 30 days

You've 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?