Skip to content

How to Set Up hCaptcha

hCaptcha is a checkbox challenge, sometimes followed by an image puzzle.

  1. On the hCaptcha tab, click Get keys. It opens the sites list in your hCaptcha dashboard.
  2. Add a site and enter your domain. Copy its Site key.
  3. Copy your account Secret key from the dashboard’s account settings.

The hCaptcha dashboard needs your own sign-in, so it is not shown here.

Go to Configuration → hCaptcha, paste the Site key and Secret key, pick Theme and Size, and click Save Changes.

The hCaptcha tab with keys saved and the live preview

Solve the Live preview & key test at the bottom of the tab and press Test.

On Configuration → General, set CAPTCHA provider to hCaptcha and click Save Changes. Open your login page in a private window to see it.

hCaptcha on the login page

hCaptcha on the My Account forms

  • Compact size fits narrow sidebars and popups.
  • The secret is your account’s, not the site’s. One secret works for every site in your hCaptcha account.
  • If hCaptcha is unreachable, Provider outage on the Advanced tab decides whether forms let people through.