Accessible & User-friendly CAPTCHA
This page outlines key accessibility aspects to consider when integrating the CAPTCHA widget into your website. It refers to the WCAG accessibility guidelines and the European Accessibility Act (EAA) to help ensure that the CAPTCHA remains accessible in your implementation.
Contrast & Colours
Section titled âContrast & ColoursâContrast
Section titled âContrastâBy default, text and background colours are designed to meet WCAG AAA contrast requirements:
- AA: Minimum contrast ratio of 4.5 : 1
- AAA: Minimum contrast ratio of 7 : 1
If you apply custom colours, make sure these contrast ratios are still met. You can find more information about customizing the design in the CAPTCHA widget overview.
Note: Text and background colour customization is available in the Enterprise plan only.
Additional Colour & Contrast Considerations
Section titled âAdditional Colour & Contrast Considerationsâ- No colour-only indicators: Important states (default, error, success) must not rely on colour alone. Always include visible text, icons, or ARIA status messages to clarify the meaning.
- Theme compatibility: If your site supports light and dark mode, verify that the CAPTCHA remains clearly visible and fully functional in both.
- Backgrounds: Avoid strong or highly variable background colours that reduce consistency and readability.
Text & Labels
Section titled âText & LabelsâClear CAPTCHA Label
Section titled âClear CAPTCHA LabelâInclude an associated label indicating what the element is, for example:
âCAPTCHA Verificationâ or âIâm not a robot checkâ
This helps screen readers and keyboard users understand that the element is a human verification step.
Readable Language & Localization
Section titled âReadable Language & Localizationâ- When customizing text, use short, clear, and descriptive language.
- The widget automatically inherits the page language (
langattribute). - If your site uses a different language or locale, explicitly set it via configuration.
For more information on changing the language and customizing texts and translations, see the CAPTCHA widget overview.
Feedback & Error Handling
Section titled âFeedback & Error HandlingâError Message on Blocked Action or High Bot Score
Section titled âError Message on Blocked Action or High Bot ScoreâIf you configure the CAPTCHA to block an action at a high bot score (e.g., form submission), you should display a clear, human-readable message. Optionally, you could provide an alternative contact method or way of verification (e.g., email).
Technical Integration & Accessibility Attributes
Section titled âTechnical Integration & Accessibility AttributesâConfigurable Accessibility Parameters
Section titled âConfigurable Accessibility ParametersâYou can configure the following properties during integration:
- Text content
- ARIA attributes
- Language
- Light/Dark mode
- Colour parameters (Enterprise plan)
When customizing, always use clear and descriptive labels (e.g. âSecurity check â I am not a robotâ instead of âcaptcha1â).
You can find more information in the CAPTCHA widget overview.
Focus, Overlays & Visibility
Section titled âFocus, Overlays & Visibilityâ- Ensure that popups, cookie banners, or chat widgets do not cover or block the CAPTCHA.
- Keep the focus indicator visible and within the userâs viewport.
Form & Page Integration
Section titled âForm & Page IntegrationâThe CAPTCHA should appear logically in the form flow (typically before the submit button).
Technical Configuration Options
Section titled âTechnical Configuration OptionsâThese advanced settings are available in higher-tier plans to tailor usability and security behaviour:
Custom Difficulty / Duration (Business & Enterprise)
Adjust how long the CAPTCHA takes. Ideal for audiences using older devices or with low threat levels, as you can keep it shorter for smoother UX.Custom Validity Period of Results (Business & Enterprise)
Defines how long a passed verification remains valid before it must be rechecked. Helpful for multi-step or delayed submission flows.Results Retrievable Multiple Times (Enterprise only)
Enables multiple uses of a previously completed CAPTCHA result in multi-step or asynchronous workflows.
You can find more information in the security rules guide.
Plan-Specific Features & Support
Section titled âPlan-Specific Features & SupportâSome accessibility options are only available in certain plans, such as Business or Enterprise.
If you have questions about activation or usage, please contact our support team.
Disclaimer (WCAG / EAA)
Section titled âDisclaimer (WCAG / EAA)âThe accessibility features and recommendations described in this documentation are based on the principles of the Web Content Accessibility Guidelines (WCAG) and the European Accessibility Act (EAA).
Final accessibility compliance will always depend on the final implementation and integration on the customerâs website or application.