> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hiveku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Up Site Review & Feedback

> Let clients annotate and leave feedback directly on your site

Site Review turns your deployed site into an interactive canvas where clients can click any element and leave a comment. No Hiveku account needed for reviewers — just share a link.

## Enable Annotation Mode

<Steps>
  <Step title="Open project settings">
    From your project, go to **Settings**.
  </Step>

  <Step title="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)

    <Warning>
      Annotation mode adds a small overlay UI to the site. Remember to turn it off on **Production** before launch so end users don't see review controls.
    </Warning>
  </Step>

  <Step title="Deploy">
    Click **Deploy** so the annotation script ships with the next build.
  </Step>

  <Step title="Open the Review tab">
    A new **Review** tab now shows up in your project sidebar. This is your triage dashboard for all incoming comments.
  </Step>
</Steps>

## Share with Your Client

<Steps>
  <Step title="Grab the review URL">
    In the **Review** tab, click **Share**. Copy the URL — it points to your deployed site with annotation mode enabled.
  </Step>

  <Step title="Send it over">
    Email or Slack the link. Your client doesn't need a Hiveku account to leave feedback.
  </Step>

  <Step title="They leave comments">
    The client visits the URL, clicks any element on the page, and types a comment. Comments are pinned to the exact element and appear for every reviewer.
  </Step>
</Steps>

## 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

<Info>
  You get a notification (email + in-app) when a new comment is left. Assignees get pinged too.
</Info>

## 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

<AccordionGroup>
  <Accordion title="Review URL doesn't load">
    You probably haven't deployed since enabling annotation mode. Click **Deploy** in the top bar and try again.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## What's Next?

<CardGroup cols={2}>
  <Card title="Team Roles" icon="users" href="/how-tos/team-roles">
    Invite teammates so they can be assigned comments
  </Card>

  <Card title="Custom Domain" icon="globe" href="/how-tos/custom-domain">
    Host review on a branded subdomain for client-facing polish
  </Card>
</CardGroup>