Guides

Setting Up Zorko: A Step-by-Step Guide for Web Agencies

From sign-up to the first piece of client feedback: creating a project, embedding the widget, locking it to your domain, inviting the team, and running the review loop.

Web professional reviewing a page on a desktop screen and taking notes
A practical field guide
In this article 9 sections

This is the whole setup, in the order you actually do it. You can finish it in one sitting, and the only thing you need from your client is their attention for a minute at the end.

Step 1: Create your account

Go to zorko.app/register and sign up with your email address.

You start on the free plan:

  • 1 project
  • 10 feedback items per month
  • AI analysis included, not held back for paid plans
  • Team collaboration and comments

That is enough to run one real client project end to end before you decide anything.

Step 2: Create a project

From the dashboard, click New project and fill in two fields:

  • Project name: whatever you and your team call it internally
  • Domain: the site the widget will live on, without https://, for example staging.clientsite.com

Create it, and the project gets its own widget key: a 32 character string generated for you. It identifies the project in every request the widget makes, so keep it with your project credentials.

Step 3: Embed the widget

Open the project menu and choose the install option. You get one line to paste into your site, just before the closing </body> tag:

<script type="module" src="https://zorko.app/widget/loader.js" data-widget-key="YOUR_WIDGET_KEY"></script>

The type="module" matters. The loader is an ES module and reads the key from the data-widget-key attribute on its own script tag, so do not drop the attribute or split the tag.

Where to paste it

WordPress: the Zorko plugin, where you paste the widget key under Settings > Zorko instead of the tag. Or a headers and footers plugin, in the footer section.

Webflow: Site Settings, Custom Code, Footer Code.

Shopify: theme editor, theme.liquid, before </body>.

Next.js: app/layout.tsx or _document.js, or next/script with strategy="afterInteractive".

Static HTML: your shared layout file, or every page you want covered.

Step 4: Check it works

Open the site. A launcher appears in the corner. Click it, mark something on the page, write a sentence and submit. The item should show up in your dashboard within seconds, screenshot included.

If nothing appears:

  1. Open the browser console and look for errors from the loader
  2. Confirm the widget key has no stray whitespace
  3. Confirm the tag has type="module"
  4. Check that the page you are testing actually includes the layout you edited

Step 5: Tune the project settings

Open the project settings. There are four tabs and you only need two of them today.

General: rename the project, change the domain, or switch the project off. A switched-off project stops accepting submissions without deleting anything.

AI: turn automatic analysis on or off. With it on, every incoming item gets a category, a priority, a sentiment read, a developer-facing summary and suggested actions before you open it. With it off, you can still run the analysis by hand from the feedback details panel.

Security: restrict submissions to your domain, and optionally require an access key so only people you send it to can report anything. Useful when staging is publicly reachable.

Integrations: a Slack webhook and a custom webhook. Both fire when feedback arrives, so you can push items into Slack, Zapier, Make, or your own endpoint.

Email notifications are per account rather than per project. You will find instant notifications and the daily digest in your account settings.

Step 6: Invite your team

Team access is managed per project. Open the project’s team panel and invite people by email.

  • Admin: everything, including settings and the team
  • Editor: reads and updates feedback, comments, changes status
  • Viewer: read only

Viewer is the role to give a client who wants to watch progress without touching anything.

Step 7: Tell your client how to use it

This is the step people skip, and it is the one that decides whether any of the rest matters.

Send a short message with the staging link:

The staging site is ready at [URL]. There is a feedback button in the corner.

Click it, mark the thing you are commenting on, type what is wrong, and submit. It takes a screenshot for us automatically, so you do not need to describe where anything is.

Everything you send lands in one place and you will see us move each item to done.

A one minute screen recording showing the button and what happens after you click it works better than any written instruction.

What your client can do in the editor

Place a pin on the exact spot, draw an arrow or a box, blur anything sensitive before it leaves their screen, and sketch freehand. On desktop browsers that support screen capture they can also record a short video, which is the right tool for anything that takes several steps to reproduce.

Step 8: Run the review loop

Your feedback view has a list and a board. The board has three columns that match the three statuses: Active, In progress and Done.

Day to day you will:

  • Filter by status, type, assignee or tag, and search the text
  • Assign an item to whoever is taking it
  • Comment to ask the client or a teammate for one more detail
  • Move status so the client can see the item progress without emailing you
  • Export to CSV when you need feedback in a report or a client meeting

A ten minute daily pass

Start the day in the board. Read the new column, correct any AI category that landed wrong, assign owners, and move anything already handled to done. Ten minutes stops the pile-up that makes feedback feel overwhelming by Thursday.

A note on limits

The free plan covers 1 project and 10 feedback items per month, which is a genuine single-project trial rather than a demo. Pro is $19 per month or $190 per year and removes both limits. The 7 day trial needs a card.


Stuck on any step? Ask us through the contact page.

Zorko news in your inbox

Product updates and practical tips for agencies, about once a month. Nothing else.

Put it into practice

Give clients the right way to show what they mean.

Zorko keeps screenshot and desktop video feedback together with the page details your team needs to act.

Start free See how it works

Free includes 1 project and 10 feedbacks a month. No credit card required.