Guide

How to annotate a website

Four ways to annotate a website, from screenshots to tools that pin comments to the element, and how to write feedback a developer can act on the first time.

Updated October 7, 2026

Annotating a website means leaving comments on the page itself: this heading is too long, that button goes nowhere, the spacing on this card is off. Done well, it's the fastest way to review a site. Done badly, it's a 40-line email that nobody can act on.

This guide covers the four common ways to annotate a website, when each one works, and how to write annotations a developer can fix without coming back with questions.

Four ways to annotate a website

1. Screenshots with markup

Take a screenshot, draw a red circle, paste it into an email or a doc. Everyone knows how, and it needs no tools.

The problems start when someone has to fix it. A screenshot doesn't say which page, which screen size or which version it came from. It can't be replied to. After two rounds, nobody knows which circles are done.

2. A shared document or spreadsheet

A row per issue, with the page URL, a description and a status column. It's better than email because everything sits in one place and has a status.

It still relies on descriptions like “the second card on the pricing page,” and the sheet drifts from the site as soon as the layout changes.

3. Browser annotation extensions

General-purpose extensions let you draw and type on top of any page. They're quick for personal notes, but most save the drawing as an image, so the result is a screenshot with extra steps.

4. Element-level feedback tools

A website annotation tool such as Skyelight pins each comment to the element on the live page. The comment knows the page, the element and its styles. It becomes a thread people can reply to, assign and resolve. It stays on the element, so the next reviewer sees it in context.

This is the method that scales past one reviewer and one round, and it's what the rest of this guide assumes.

Annotate your site with Skyelight

Press C, click any element on a live page and write your comment. Clients and stakeholders join free on every plan.

How to annotate a website, step by step

Step 1: Open the live page

Review the real page, in production, on staging or on a preview link. Static mockups and screenshots hide what matters on the web: hover states, loading, real content and how the layout behaves at different widths.

Step 2: Point at the element

Click the exact thing the comment is about. If it's a phrase, highlight the text. Pointing removes the most common question a developer asks: “which one do you mean?”

Step 3: Say what's wrong and what you expected

A comment a developer can act on has three parts:

  • What you see. “The button says Submit.”
  • What you expected. “It should say Start free trial, like the hero.”
  • Why, if it isn't obvious. “Submit sounds like a form, not a sign-up.”

Keep it to one issue per comment. Two issues in one comment means one of them gets missed or the thread can't be resolved.

Step 4: Assign it and follow it to done

Every annotation needs an owner. Assign it to the person who will fix it, reply on the thread when the change is made, and resolve it once you've checked it on the page. Open threads then tell you exactly what's left before launch.

Tips for better website annotations

  • Sort as you go. Mark each comment as a bug, an idea or a copy change, so polish requests don't block a launch. Skyelight suggests the type from what you wrote.
  • Write decisions down. When a question is settled in a thread, the answer stays next to the element. That ends the “didn't we already decide this?” loop.
  • Review at real sizes. Check the page on a phone as well as a laptop. Many layout bugs only appear on small screens.
  • Let your coding agent read the threads. With Skyelight's MCP server, Claude Code, Cursor or Codex can read each annotation with its source file and line, fix it and reply on the thread.

Frequently asked questions

Can I annotate a website I don't own?

Yes. A Chrome extension works on any page you can open. To let clients annotate without an extension, the site needs a script or build plugin, which only the site's owner can add.

Can I annotate a site behind a login?

Yes. You annotate the page as you see it, signed in. Skyelight never stores form values, passwords or payment details from the page.

What's the best free website annotation tool?

For one project, Skyelight's free plan includes the Chrome extension, Skyelight Build and unlimited reviewers. See pricing for what's on each plan.

Annotate your next review in Skyelight

No card required.