Enable Annotation Mode
Turn on annotation mode
Find Annotation Mode and toggle it on for the environment you want reviewed:
- Development — safest starting point, only internal reviewers
- Staging — for client review before launch
- Production — only if you want public feedback (rare)
Share with Your Client
Grab the review URL
In the Review tab, click Share. Copy the URL — it points to your deployed site with annotation mode enabled.
Triage Comments
Back in the Review tab, you see every comment across every page.- Thread replies — reply inline to ask for clarification
- Filter by status — open or resolved
- Assign to a team member — click the avatar to assign
- Resolve — click the check mark when addressed
You get a notification (email + in-app) when a new comment is left. Assignees get pinged too.
Best Practices
- Scope the ask. Tell your client what you want feedback on — copy, layout, brand — so comments are focused instead of scattered.
- Set a deadline. “Please leave all feedback by Friday” prevents a trickle that stalls the project.
- Batch fixes. Wait until the first review pass is complete before pushing updates — it’s easier to address 20 comments in one session.
- Disable on production. Once the site is approved and launched, turn annotation mode off on the production environment.
Verifying It Works
Open the review URL in an incognito window, click any element, and leave a test comment. It should appear in the Review tab within a few seconds, pinned to the right element.Troubleshooting
Review URL doesn't load
Review URL doesn't load
You probably haven’t deployed since enabling annotation mode. Click Deploy in the top bar and try again.
Comments aren't saving
Comments aren't saving
Usually a network hiccup on the reviewer’s side. Ask them to refresh and retry. If it persists, check your browser console for errors and share any you see with support.
Client says they can't leave a comment
Client says they can't leave a comment
Ask them to try a different browser or clear cache — old service workers from a previous visit sometimes intercept the annotation script. Chrome incognito almost always works as a quick test.
Annotation overlay is hiding content
Annotation overlay is hiding content
The overlay UI sits in a corner and shouldn’t block content. If it is, toggle it off for production and leave it on only for staging or development.
What’s Next?
Team Roles
Invite teammates so they can be assigned comments
Custom Domain
Host review on a branded subdomain for client-facing polish