Getting started

From zero to your first bug report in about two minutes.

1. Create a project

A project represents one site you collect bug reports from — for an agency, that's one client site. Go to Projects, type a name, and create it. Each project gets its own key (pk_…) so reports arrive tagged with which site they came from.

2. Install the widget

Open the project's Widget settings and copy the snippet from the Install the widget box at the top — it already has that project's key filled in. Paste it just before the closing </body> tag of the site:

<script
  src="https://bugclip.dev/widget.js"
  data-project-key="pk_your_project_key"
  defer
></script>

That's the whole install. No npm package, no browser extension, no build step — the person reporting bugs needs nothing installed at all.

3. Check it's live

Load the site and a small 🐞 Report a bug launcher appears in the corner (you can change its text, color, and corner in Widget settings). Click it, send a test report, and it shows up under Recordings.

The widget only ever activates when someone clicks the launcher. It records nothing in the background — see What gets captured.

Next