Widget reference
Attributes, the JavaScript API, sizes, themes and languages.
| Attribute | Option | Meaning |
|---|---|---|
data-sitekey | sitekey | Required. |
data-action | action | Names the form (login, signup); returned by siteverify and used for per-action levels. Letters, digits, - and _, up to 32. |
data-cdata | cdata | Your own data, returned by siteverify. Up to 255 of the same characters. |
data-theme | theme | auto (default), light or dark. |
data-size | size | normal (300×65), compact (150×140) or invisible. |
data-language | language | A language tag such as de or pt-BR. Default: the visitor's browser language. |
data-response-field-name | responseFieldName | Name of the hidden field (default botbar-response); false adds none. |
data-callback | callback | Called with the token. |
data-expired-callback | expiredCallback | The token expired (after 5 minutes); a new one follows automatically. |
data-error-callback | errorCallback | network, failed, invalid-sitekey or invalid-hostname. |
Puzzles
When a puzzle is needed it opens over the page, whatever the widget's size, and closes when it's solved or cancelled.
Languages
32 languages: ar, bn, cs, da, de, el, en, es, fa, fi, fr, he, hi, hu, id, it, ja, ko, ms, nb, nl, pl, pt, ro, ru, sv, th, tr, uk, vi, zh-CN, zh-TW. Arabic, Hebrew and Persian lay out right to left.
Content Security Policy
Allow the API origin in script-src and frame-src.