Skip to Content
annotyDocs

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 situationUse
A public page, and you want feedback todayProxy
You can't change the site's codeProxy
Staging behind a login, or Vercel or Netlify preview protectionEmbed
An app where reviewers sign in to see their own dataEmbed
A new preview deploy for every branchEmbed, with the project embed link
A preview behind a password, with no link to sendEmbed, with the key on the script
A page that doesn't work right on annoty.siteEmbed

Proxy and embed compared

ProxyEmbed
SetupNoneOne script tag per site, once
Address reviewers see<name>.annoty.siteYour own domain
Behind a login or preview protectionNoYes
One link for every branchNoYes, the project embed link
PlansAll plansPro and Team
Who can commentAnyone with the link, and its password if setAnyone 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.

On this page