Yaplet's bug reporting is the fastest way for a visitor to tell you something is broken. One click from the widget opens the report form, and console logs, network logs, the pages they visited and device metadata travel with it automatically — the visitor can also attach an annotated screenshot and a screen recording. This article shows you how to put the button on your widget's home screen.
1. Open the chat widget
In the sidebar, open Brand → (your brand) → Chat widget. There is no Widgets list page any more and no "new widget" dialog — a chat widget comes into existence with the brand, so this row is the widget.
2. Add a bug report card to the Home screen
- Open the Home tab.
- Under Home Cards, click Add Card.
- Choose the card type Form / Bug Report.
- Give it a Title such as "Report a bug" and, if you like, a short Description.
- Pick your bug form under Form to Open.
- Set Card Icon to Bug so visitors recognise the button.
Use the arrows on each card to move it up or down — cards appear on the home screen in the order they are listed here.
Whether visitors are offered the screenshot and recording buttons is decided on the form itself, by its Enable screenshot and Enable recording switches. Both are already on for the bug form Yaplet created with your account.
If you do not have a bug board and form yet
The Form to Open dropdown only lists forms that already exist, so make one first:
- In the sidebar, under Communications → Tickets, click ＋ New board at the bottom of the list. It creates a board and opens its Settings tab.
- Rename it, set Type to Bug, and save.
- Switch to the board's Forms tab and click Add form. A description field is usually all a bug form needs — everything else is captured automatically.
Creating a board needs the Board management right and building the form needs Forms. Both come with the Feedback boards & bug tracker add-on.
3. Save
Click Save Changes. The button appears on your widget's home screen immediately, on every page where the widget is installed.
What visitors see
Clicking the button opens the form. The visitor answers the questions, and on the last step — if the form has them switched on — an 📸 Add Screenshot and a 🎥 Add Recording button appear. Pressing Add Screenshot captures the page and overlays a small drawing toolbar so they can mark up the problem area, then returns them to the form to submit. Console logs, network logs, the pages they visited and device metadata are collected in the background, with nothing for the visitor to do.
Session replay is not part of this. It is a separate paid add-on and stays off until you switch it on — see Session replay — what it is and how to enable it.
Next steps
Now that the button is live, learn what data is collected with each report — see What gets captured when a user reports a bug.