Set options as data-* attributes on the script tag. Anything you leave out uses the default.
<script
async
src="https://cdn.whatsnew.xrisstech.com/w.js"
data-key="pk_your_public_key"
data-display="sidebar"
data-mode="dark"
data-color="#6d5efc"
></script>
| Attribute | Default | Values |
|---|---|---|
data-key |
required | Your project's public key (pk_…) |
data-launcher |
floating |
floating shows the round button; none uses your own elements (install) |
data-position |
bottom-right |
bottom-right, bottom-left, top-right, top-left (floating button) |
data-display |
popover |
popover, sidebar (full-height panel at the side), modal (centered) |
data-mode |
auto |
light, dark, or auto to follow the visitor's system setting |
data-color |
your project's color | Brand color for the button, highlights and focus ring, as #rrggbb |
data-background |
theme | Panel background, as #rrggbb. Pro plan (themes) |
data-text |
theme | Panel text color, as #rrggbb. Pro plan |
data-locale |
the browser's | Language for dates, such as pt-BR or de |
data-debug |
off | Add data-debug to log problems to the console |
Invalid values fall back to the default; the widget never throws an error into your page.
On phones, every display becomes a sheet at the bottom of the screen.
The Install page in the dashboard builds the snippet for you and shows a live preview of each option.