- Guides
- Report button
Report button
Show, move, theme and rename the floating report button, from the console or from your script.
The floating button your visitors press to report a problem. You can configure it in two places, and the project setting wins over the script.
From the console
Section titled “From the console”Open Project settings → Report button and choose:
- Shown or hidden. Hidden removes the button from every page.
- Corner: top left, top right, bottom left or bottom right.
- Theme: auto follows the visitor’s system, light or dark always uses that theme.
- Icon: one of the offered emojis, or the address of your own image. It has
to be an
httpsURL, with no spaces or credentials. - Texts: the button label, the dialog title, the hint inside the text box and the send button, up to 120 characters each. An empty field keeps the default, which is in Spanish.
It applies to every visitor with no HTML change, and new page loads pick up a change within about 5 minutes. A value you leave empty falls back to what your script says, or to the default.
From your script
Section titled “From your script”| Attribute | Effect |
|---|---|
data-button="off" | Does not show the button. Use it when you open the report from your own interface. |
data-position | bottom-right (default), bottom-left, top-right or top-left. |
data-theme | auto (default), light or dark. |
data-button-icon | An emoji, or an https image URL. Default: 🐞. |
data-video="off" | The button no longer offers screen recording. See Privacy controls. |
<script src="https://app.espejo.dev/sdk/espejo.js" data-key="pk_live_…" data-position="bottom-left" data-theme="dark" data-button-icon="💬"></script>With a bundler, the options are button, position, theme, buttonIcon and
buttonText. buttonText replaces texts one by one: triggerLabel, title,
fieldLabel, placeholder, cancel, submit, sending, success and
errorPrefix among others. Only triggerLabel, title, placeholder and
submit can be set from the console.
To report from your own interface, see Build your own report button.