Back to Blog

How to Set Up Visual Bug Reporting in 5 Minutes

I designed Lairo to be fast to set up. You shouldn't need a tutorial to get visual feedback flowing. But here's the walkthrough anyway, just to be clear.

Step one: create your Lairo account

Go to lairo.io and sign up. Email address, password. That's it. No phone verification, no waiting for confirmation. You're in immediately.

You land on the dashboard with an empty projects list.

Step two: create your first project

Click "New Project." Give it a name. This is where all your feedback for one site or app will live. If you manage three client sites, you'll create three projects.

You can add a description, a project URL, and settings. For now, the name is enough. Click create. You're done.

Step three: choose your feedback method

You have two options here, and you can use both.

Option A: embed the widget

Lairo generates a script tag. You paste this into your site's HTML, and a feedback widget appears. Your client clicks the icon, reports a bug, done. The widget is small and customisable. You can choose the icon, the label, the colour, where it sits on the page.

On Starter+ plans, you can customise all of this. On the free plan, the widget is fixed in the bottom-right corner.

If you already have git access to your client's site, this is the fastest approach. Add one script tag, deploy, done.

Option B: generate a capture link

A capture link is a shareable URL that opens a feedback overlay on your site. Your client doesn't install anything. They click the link, see the site with a feedback layer, click where the problem is, add a comment, and submit. No account required on their end.

You can generate as many links as you want. You can set expiry dates, max number of uses, and whether the reporter needs to enter their name. Then you share the link via email, Slack, or your project management tool.

If your client is non-technical or you want zero friction, capture links are perfect.

Step four: share with your client

If you chose the widget, your site is already live with it. Done.

If you chose a capture link, send them the link. They click it. They see your site with the feedback overlay. They click where something's wrong, add a comment, and submit.

That's it. You've set up visual bug reporting.

Step five: start receiving feedback

Feedback arrives in your Lairo dashboard. Every submission includes a screenshot with click location marked, browser and operating system, viewport size, console errors, and session replay (if on a Starter+ plan).

No more emails saying "something's broken." No more guessing what device they were on. You have complete context.

Organising your feedback

As feedback comes in, you'll want to move it through a simple workflow. Lairo provides four states: Open, In Progress, Resolved, Closed.

On the free plan, everything stays in Open. You read it and manually track it in your system.

On Starter+ plans, you can move feedback between states. Assign priority levels. Add notes. Set it up so your workflow mirrors how you actually work.

Integrations (optional)

If you want feedback to automatically flow into GitHub or Linear, that's a Pro plan feature. You authenticate once, and feedback starts syncing automatically with full two-way status sync.

For most people starting out, you don't need this. You can read feedback directly in Lairo and manually create issues if you want. Integrations become valuable as you scale.

That's really it

Five minutes. Account created. Project created. Widget embedded or link generated. Feedback flowing.

Start free. Get a feel for it. If you need session replay, multiple projects, or integrations, upgrade when it makes sense. Visual bug reporting should be simple. It is.