Skip to Content
annotyDocs

Getting started

Sign up, add your site and read your first comment in about five minutes, with nothing to install.

This guide takes you from sign-up to your first comment with a proxy link: a link on annoty.site that opens your site with the comment toolbar on top. Nothing to install, so any public page works.

If you use Claude Code, Cursor or Codex, the dashboard's Overview has setup steps for your coding agent: it creates the project, installs Annoty on the site or makes a proxy link, and later fixes what reviewers find.

Create your account

  1. Go to dash.annoty.app/signup and sign up with Google or GitHub, or with your name, email and a password of at least 8 characters.

  2. If you signed up with email, open the link Annoty sends you. It expires after an hour.

You get your own organization with 14 days of Pro, no card needed. If a teammate invited you, sign up with the address the invite went to and you join their organization instead.

Add your site

A project is one site. Its feedback sessions and their comments live under it.

  1. Go to Projects and click New project.

  2. Enter a Name, like "Marketing site", and the site's Domain, like example.com. A pasted URL is fine: only its domain is kept.

  3. Click Create project, then open it from the list.

Start a feedback session

A feedback session is one review round, like "Homepage redesign". Its comments stay together, apart from the next round's.

  1. On the project's page, click New feedback session.

  2. Enter a Label and turn Proxy link on: nothing to install.

  3. Enter the Page reviewers start on: the live site, a staging copy or one page.

  4. Click Create feedback session, then open it from the list.

  1. On the feedback session's page, click Share. Copy the link in the Proxy tab.

  2. Send it to your reviewers.

Reviewers open the link, click Comment on the toolbar, then click any element on the page and type. They add their name with their first comment and don't need an account.

To try it yourself first, click Open on the feedback session's page. You review signed in, and your comments carry your name.

Read and answer comments

Comments show up on the feedback session's page as reviewers post them, each with a screenshot of what the reviewer saw.

  • Reply to answer. The reviewer sees your reply in the toolbar, marked Team.
  • Resolve a comment once it's done. Reopen brings it back.

Next steps

  • If your site is behind a login or Vercel or Netlify preview protection, leave Proxy link off and use embed instead: one script tag, and reviewers comment on your own domain, on Pro and Team. Proxy or embed? compares the two.
  • Bring in your team under Settings → Members with Invite.
  • Get notifications in Slack, Discord or by email.
  • Send new comments to your own tools with a webhook, or start a Zapier Zap or an n8n workflow from them.
  • Let a coding agent read the comments, fix the code and resolve the threads.

On this page