Visible labels
The widget does not ship a fixed language. Override every visible state with data-i18n attributes on the element.
| Attribute | Default | Used when |
|---|---|---|
| data-i18n-initial-state | Verify you are human | The widget is idle and ready to start. |
| data-i18n-verifying-label | Verifying... | A challenge is currently being solved. |
| data-i18n-solved-label | Verified | A token has been issued successfully. |
| data-i18n-error-label | Try again | A generic challenge error occurred. |
| data-i18n-compact-initial-label | Protected | Compact badge text before a challenge starts. |
| data-i18n-compact-verifying-label | Verifying | Compact badge text while proof is being calculated. |
| data-i18n-compact-verified-label | Verified | Compact badge text after a token has been issued. |
| data-i18n-compact-error-label | Blocked | Compact badge text when protection blocks or fails the attempt. |
Error labels
| data-i18n-limit-label | Monthly protected attempt limit reached | Shown when the project has reached its monthly protected attempt limit. |
| data-i18n-billing-error-label | Billing action required | Shown when billing status blocks new challenges. |
| data-i18n-unavailable-label | Verification unavailable | Shown when the challenge backend is temporarily unavailable. |
| data-load-error-label | HumanProof could not load. Please allow the widget script and try again. | Shown by the watchdog fallback when the custom element cannot initialize. |
Accessibility labels
Use ARIA labels when your visible copy is short, icon-only, or not descriptive enough for assistive technology.
<human-proof
data-i18n-verify-aria-label="Click to verify you are human"
data-i18n-verifying-aria-label="Verification in progress"
data-i18n-verified-aria-label="Human verification completed"
data-i18n-error-aria-label="Human verification failed"
></human-proof>Example
<human-proof
data-api-endpoint="https://humanproof.eu/api/captcha/site_your_public_key"
data-i18n-initial-state="Bestätigen"
data-i18n-verifying-label="Wird geprüft..."
data-i18n-solved-label="Bestätigt"
data-i18n-error-label="Bitte erneut versuchen"
data-i18n-verify-aria-label="Klicken, um die Prüfung zu starten"
></human-proof>