Proxy or embed?
The two ways reviewers open a feedback session, and when to use each.
Every feedback session has an embed link, and a proxy link if you turn Proxy link on when you create it. Both open the same comments, so you can use either one, or both.
- Proxy link:
https://homepage-redesign-k3x9m2qa.annoty.site. Annoty loads your site on annoty.site and adds the comment toolbar. Nothing to install. - Embed link:
https://staging.example.com/#annoty=rk_…. Your own site, with the toolbar added by the embed script you install once.
Find both under Share on the feedback session's page. If you left Proxy link off, you can add one later under Share → Proxy, or remove it there.
Which one fits your site
| Your situation | Use |
|---|---|
| A public page, and you want feedback today | Proxy |
| You can't change the site's code | Proxy |
| Staging behind a login, or Vercel or Netlify preview protection | Embed |
| An app where reviewers sign in to see their own data | Embed |
| A new preview deploy for every branch | Embed, with the project embed link |
| A preview behind a password, with no link to send | Embed, with the key on the script |
| A page that doesn't work right on annoty.site | Embed |
Proxy and embed compared
| Proxy | Embed | |
|---|---|---|
| Setup | None | One script tag per site, once |
| Address reviewers see | <name>.annoty.site | Your own domain |
| Behind a login or preview protection | No | Yes |
| One link for every branch | No | Yes, the project embed link |
| Plans | All plans | Pro and Team |
| Who can comment | Anyone with the link, and its password if set | Anyone with the link |
Turning a feedback session off, or reaching its end date, stops its links. The comments stay.
When your trial ends without a plan, every link pauses: a proxy link shows reviewers that the review is paused, and an embed link doesn't open the toolbar. Choose a plan and they work again within 5 minutes, with the comments left so far.
Sites a feedback session was opened on
The feedback session's page lists under Opened on every site reviewers opened it on, with the date it was first and last opened there: your staging and production sites, your dev server, and the proxy link. A site shows up once someone opens a link on it. The embed script does nothing on a site until someone opens a link there, so a site that only has the script isn't listed.
Through the REST API: GET /v1/feedback-sessions/{feedbackSessionId}/sites.