Verification modes
The selected mode controls how HumanPass appears to visitors. Security policy, origin validation, expiry, and one-time server verification remain enforced in every mode.
Checkbox
Section titled “Checkbox”Displays an accessible control that the visitor activates explicitly.
Use Checkbox when:
- you want a familiar, visible verification step;
- the protected action is user initiated;
- an explicit interaction is acceptable in the flow.
Non-interactive
Section titled “Non-interactive”Displays verification status and starts automatically without requiring a click. It remains visible so the visitor can see progress, success, or failure.
Use Non-interactive when:
- you want visible feedback with less friction;
- verification can begin as soon as the widget loads;
- the page can accommodate a persistent status component.
Non-interactive never silently changes into a clickable checkbox. A failure is displayed and verification fails closed.
Invisible
Section titled “Invisible”Renders no persistent widget and starts only when your code calls solve().
Use Invisible when:
- verification must align with a custom button or multi-step flow;
- you can handle progress and error states in your own interface;
- your code can obtain a fresh token immediately before submission.
Invisible is not weaker or optional. Your backend must still verify the returned response.
Because Invisible mode does not keep a visible HumanPass widget on the page, you must identify Valgix HumanPass in your own privacy policy and link to the HumanPass Privacy Addendum. Provide a clear notice before or when HumanPass begins processing the visitor’s request. If applicable law requires prior consent, do not start HumanPass until that consent has been obtained.
A suitable notice is:
This site uses Valgix HumanPass to protect forms and services from automated abuse. HumanPass processes limited device, browser, network, and verification signals. See the HumanPass Privacy Addendum.
Which mode should I choose?
Section titled “Which mode should I choose?”| Requirement | Recommended mode |
|---|---|
| Clear, explicit user interaction | Checkbox |
| Visible status without a click | Non-interactive |
| Fully custom presentation or timing | Invisible |
Start with Checkbox if you are unsure. Change the mode in the dashboard without modifying your HTML; connected widgets obtain the server-authoritative setting.