Set up annotix in minutes

Overview

annotix turns any live webpage into a place where your team can pin precise feedback — a broken button, a headline that misses, a paragraph that needs rewriting. Each pin captures a screenshot and becomes a structured task with a title, priority, assignee, and status, all reviewable on a single Kanban board.

To pin feedback on a page you need annotix running on that page. There are two ways to make that happen, and you can mix them freely across your team:

• The browser extension — best for testers, editors, and clients who review many different sites. Installed once, works everywhere your workspace has a project.
• The JavaScript embed — best for your own site or a staging environment. Drop one <script> tag and the whole team can pin feedback without installing anything.

Ways to run annotix

Browser extension — Chrome & Edge

annotix ships as a single Manifest V3 extension that runs in both Chrome and Microsoft Edge (Edge is built on the same Chromium engine, so the Chrome Web Store listing installs directly in Edge too).

Install

1. Open the annotix Chrome Web Store listing and click Add to Chrome (it installs in Microsoft Edge too).
2. Pin the annotix icon to your toolbar so it's one click away.
3. Sign in from the extension popup with your annotix email and password. Your token is shared with the web console — sign in once.
4. Pick your workspace in the popup if you belong to more than one.

How it knows where to work

The extension automatically activates on any page that falls inside one of your workspace's project URL scopes. When you're on a matching page, the annotix launcher appears and the + button is enabled. On pages with no matching project, the launcher stays hidden — so it never gets in the way on sites you don't track.

JavaScript embed

The embed is the same annotix overlay as the extension, delivered as a script you host nowhere — just point at ours. It's ideal for your own product, a staging site, or a client preview, where you'd rather not ask everyone to install an extension.

Add the snippet

Drop this just before the closing </body> tag on any page you want to collect feedback on:

<!-- annotix feedback widget -->
<script src="https://annotix.eu/embed.js" defer></script>

That's the whole installation. The script loads the overlay, but — importantly — it shows nothing to your anonymous visitors. The sign-in button only appears for your team, on demand (see below).

Sign in (the hidden trigger)

So that the public never sees an annotix button on your live site, the embed stays invisible until a team member reveals it. There are three ways to bring up the sign-in card:

1. Keyboard shortcut — press Alt + Shift + A on Windows / Linux, or ⌥ Option + ⇧ Shift + A on macOS.
2. URL flag — append #annotix to the page URL (or ?annotix in the query string) and reload. Handy to share a "feedback mode" link with a reviewer.
3. Always-on — add data-annotix-launcher="always" to the script tag to show the launcher to everyone (use this only on a private staging site).

Once you sign in, your token is stored in the browser, so annotix re-appears automatically on your next visit — no shortcut needed. Anonymous visitors who never trigger it stay completely unaware it's there.

Projects & URL scope

A project is a named scope tied to a starting URL — a domain, a subdomain, or a path. annotix routes every pin to the right project automatically by matching the page URL against your projects, choosing the most specific (longest) match.

• Domain — example.com covers the whole site.
• Subdomain — app.example.com covers just that subdomain.
• Path — example.com/blog covers /blog and everything beneath it.

Create projects from the web console under Projects: give it a name and a Starting URL, and optionally tick include subdomains. Scopes are unique per workspace, so a given URL always resolves to one project.

Pinning feedback

1. Open the launcher on a page that's in scope (extension) or after signing in (embed).
2. Click the element you want to comment on — a button, a paragraph, an image. annotix anchors the pin to that exact element.
3. Describe it — add a title and description, choose a type (bug or content) and a priority. A full-page screenshot is captured automatically.
4. Save. The pin becomes a task in your workspace and shows up on the board for the whole team.

Pins stay anchored as you navigate the site, and the overlay follows single-page-app route changes so feedback always lines up with the right view.

Reviewing on the board

Sign in to the web console to see every pin across all projects in one Kanban board — Open, In Progress, Blocked, Done. Filter by project, assignee, or free-text search.

Click any card to open the detail drawer: the captured screenshot, an editable title and description (auto-saved), status / priority / assignee, and a comment thread. Each task also shows who created it, so it's always clear where a piece of feedback came from.

FAQ

Do I need the extension and the embed?

No — either one is enough. Use the extension for reviewing many external sites; use the embed when you'd rather not install anything on your own site. Many teams run both.

Will my website visitors see the annotix button?

No. The embed is hidden from the public by default and only reveals its sign-in card to a team member who triggers it with the keyboard shortcut or the #annotix URL flag.

Does the extension work in Edge?

Yes. It's a standard Chromium extension, so it installs and runs in Microsoft Edge just like in Chrome.

Where is my data stored?

Feedback, screenshots, and accounts live on the annotix backend you connect to. Fonts and the widget are self-hosted by annotix — no Google Fonts or third-party CDNs — to keep data within the EU.