Skip to content
Toado Docs

Embedded widget

What it will be

A small JavaScript snippet you drop into your own site. End users (your customers) can click it to submit a bug report with the same one-click capture experience as the Chrome extension, but without installing an extension.

Use case: you want to give your customers an easy way to file bugs against your product, with the screenshot and DevTools context Toado captures. The widget produces tickets in a project you designate.

Planned shape

<script async
  src="https://widget.toado.dev/v1/loader.js"
  data-project-id="proj_abc123"
  data-token="public_widget_token_..."
></script>

A floating button appears in the bottom right corner (configurable). End users click it to open a small overlay with:

  • “Report a bug” / “Send feedback”.
  • A capture button.
  • A description field.
  • An email field (optional).

On submit, the capture lands as a ticket in the project, with created_by recorded as an external user (with the email captured as metadata).

Planned configuration

  • Position: corner of the screen, color, label, hide on certain pages.
  • Required fields: email, name, custom fields.
  • Per-page project routing (e.g., reports from /billing go to a different project).
  • Custom branding (later, paired with a Custom Branding feature).

Privacy implications

Because the widget runs on your site (not in an extension), it captures only what is visible on the page at the moment of click and the network/console activity since page load. The constraints are otherwise the same as the extension.

Where to next