Open your project and select Widget setup to customize the widget. Changes are saved automatically, and the preview shows how the trigger and available submission actions will look.
Widget setup contains an installation code section, appearance settings, form and recording settings, and a live preview. For CDN script attributes and the window.snappa API, see CDN setup.
Appearance and trigger
| Setting | What it controls | Default |
|---|---|---|
| Button position | Place the trigger in the top-left, top-right, bottom-left, or bottom-right corner. | Bottom right |
| Primary brand color | The trigger's primary color. The text color is selected to contrast with it. | #0751f1 |
| Button text | Text displayed on the trigger. If empty, the trigger is rendered as a square icon button. | Report a bug |
| Button size | Trigger dimensions in pixels. The dashboard accepts values from 24 to 96. | 40 |
| Button radius | Trigger corner radius in pixels. The dashboard accepts values from 0 to 32. | 8 |
| Button icon | Choose an icon or no icon. Options include Bug, Alert, Help, Flag, Idea, Support, Chat, Message, Edit, Search, Send, Report, Warning, Fix, and Notify. | Bug |
| Show "Powered by" branding | Show or hide the Snappa attribution in the widget menu. | On |
Reporter form
| Setting | What it controls | Default |
|---|---|---|
| Include Email field for not-registered users | Allow unregistered reporters to provide an email address so they can receive updates. | On |
| Automatically subscribe reporters | Subscribe the reporter to issue notifications. | Off |
Reporter identity can also be passed at installation with data-user-* attributes or updated at runtime with window.snappa.setUser(). See Data attributes and the JavaScript API.
Submission methods and recording limits
| Setting | What it controls | Default |
|---|---|---|
| Allow selecting page elements | Show the element-selection action so a reporter can select and annotate a page element. | On |
| Allow voice recording | Show the Speak & Report action. When enabled, maximum voice recording duration can be set from 1 to 60 seconds. | On; 60 seconds |
| Allow video recording | Show the Record Video action. When enabled, maximum screen recording duration can be set from 1 to 60 seconds. | Off; 60 seconds |
Audio and video recording settings are subject to the project's plan feature access. Reporters must also grant microphone or screen-sharing permission when prompted by their browser.
Learn more about element selection, audio submissions, and video submissions.
Browser context attached to reports
These options control whether recent browser context is attached to submitted reports. They are off by default.
| Setting | What it controls | Default and limits |
|---|---|---|
| Include console logs | Attach recent browser console logs. Configure the maximum number of events (1–1,000) and the capture window (1–60 seconds). | Off; 100 events; 60 seconds |
| Include network events | Attach recent network activity. Configure the maximum number of events (1–1,000) and the capture window (1–60 seconds). | Off; 100 events; 60 seconds |
| Include session replay | Attach a privacy-masked replay of the recent visitor session. Configure the capture window (1–60 seconds). | Off; 60 seconds |
Console logging, network events, and session replay may require plan feature access. If a feature is unavailable on the project's plan, the dashboard displays a plan notice.
Installation code and preview
The Installation code section provides the CDN script snippet for the project. Use CDN installation for details on adding the script to your site.
The Widget preview reflects the trigger appearance and which submission actions are enabled. It is a preview of the widget configuration, not a substitute for testing a report on an allowed website origin.