Celebrate WordCamp Europe - 30% OFF! Use coupon WC30 - View Details


This field is used to add an hCaptcha to your form. An hCaptcha detects whether the user of a site is human. Filling out an hCaptcha is similar to filling out a reCAPTCHA.


WS Form Pro supports all current versions of hCaptcha, including:

  • Default
  • Invisible

Register Your Website with hCaptcha

In order to use hCaptcha, you first need to create an hCaptcha account.

Once you have registered, you will be provided with two keys:

  • Site key
  • Secret key

Submissions Using Enterprise Accounts

When a submission is successfully made on your website and you have an Enterprise hCaptcha on the page, hCaptcha provides a spam score. The spam score is stored against your submissions and is represented as a colored circle on the submissions page. If you hover your mouse cursor over the colored circle, you can see the percentage score WS Form has given a submission in terms of spam scoring. The scoring ranges from 0% (not spam, shown in green) to 100% (blatant spam,  shown in red).

Add hCaptcha to Your Form

To learn how to add, edit, clone, move, resize, offset, or delete a hCaptcha field, please click here.

To edit the settings for this field type, click the settings icon on the field itself. Click the Save & Close or Save button to save your changes. If you do not want to save your changes, you can click the Cancel button or click any other form element to close the field settings sidebar.

WS Form - Field Settings Icon


The basic tab contains settings that the majority of WS Form users will need to control a field. The settings are as follows:


This is the label shown alongside the field. As well as entering a label into this field, you can also double click the label of the field in the editor. You should enter an easy-to-understand label for your field, for example, First Name or Email.

Show Label

If enabled the label will be shown on your form. If you do not want the label to appear for a particular field, uncheck this box.

hCaptcha Type

Select the appropriate hCaptcha version from the select pulldown. Depending on which version you choose, you will then be prompted to provide the following information:

Site Key

Enter the site key provided when you registered your website. You can also enter a global site key to use for all you hCaptcha fields in global settings.

Secret Key

Enter the secret key provided when you registered your website. You can also enter a global secret key to use for all you hCaptcha fields in global settings.


You can choose default or invisible for your hCaptcha type.


Visible hCaptchas are available in a dark or light theme. Choose a theme that suits your website design.


As well as the normal-sized reCAPTHCA, a compact version can also be selected.

Help Text

The help text setting enables you to add smaller text under the field to assist the website visitor in completing that field.

As well as inserting plain text into this field, WS Form also provides extensive functionality for adding character and word count information. Click here to learn more about this functionality.

WS Form variables can be entered into this field.


The advanced tab contains additional settings that provide further control over how a field is rendered.


Use the Styles settings to change the design of the text field.

Vertical Alignment

The vertical alignment option allows you to choose how this field will be vertically aligned in relation to fields in the same row. The options are:

  • Top
  • Middle
  • Bottom


For developers WS Form allows you to add your own classes to fields.

Field Wrapper

The wrapper CSS class setting enables you to add a class (or classes) to a field wrapper. Field wrappers are sections of HTML added around a field to position them on the page. To add multiple classes, add a space between the class names.


User Status

Choose from one of the options to filter which user status can see this field:

  • Any
  • Is Logged In
  • Is Logged Out
  • Has User Role or Capability

If you choose Has User Role or Capability, additional settings will appear that enable you to choose one or more roles or capabilities.



Choose the desired language for the hCaptcha.


Show Invalid Feedback

Invalid feedback text is shown when a form is saved or submitted, and the field has not been completed according to the field settings you have configured. For example, if the minimum character count is 10 and you enter 5 characters and then submit the form, the field will be deemed invalid. If this setting is checked, invalid feedback is shown under the field.

Invalid Feedback Text

WS Form automatically builds invalid feedback text for all of your fields. If no text is entered into this field, the value shown in the field in light gray text will be shown. If you would like to specify alternative invalid feedback text, you can enter it within this setting.

WS Form variables can be entered into this field.


The breakpoint settings define the width of a field and also what the offset (how many columns from the left-hand side of the form or the previous field) of a field is for each breakpoint. For more information about the breakpoint settings and capabilities of WS Form, click here.