This field is used to add a reCAPTCHA to your form.
WS Form Pro supports all current versions of reCAPTCHA, including:
- Version 2 – Image / Audio reCAPTCHA
- Version 2 – Invisible reCAPTCHA
- Version 3 – Action based invisible reCAPTCHA
Register Your Website with reCAPTCHA
In order to use reCAPTCHA, you first need to register your website with Google’s reCAPTCHA admin page.
- To register for a Version 2 reCAPTCHA, click here.
- To register for a Version 3 reCAPTCHA, click here.
Once you have registered your website, you will be provided with two keys:
- Site key
- Secret key
Version 3 Submissions
When a submission is successfully made on your website and you have a Version 3 reCAPTCHA on the page, Google 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).
Adding a reCAPTCHA Field
To learn how to add, edit, clone, move, resize, offset, or delete a reCAPTCHA field, please click here.
Field Settings
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.
Basic
The basic tab contains settings that the majority of WS Form users will need to control a field. The settings are as follows:
Label
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.
reCAPTCHA Type
Select the appropriate reCAPTCHA 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 reCAPTCHA 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 reCAPTCHA fields in global settings.
Hidden
If checked the field will be hidden on the form. It can be shown again using conditional logic or your own JavaScript.
Version 2 Settings
Type
You can choose image or audio for your reCAPTCHA type. The audio reCAPTCHA is a convenient option for the visually impaired.
Theme
Visible reCAPTCHAs are available in a dark or light theme. Choose a theme that suits your website design.
Size
As well as the normal-sized reCAPTHCA, a compact version can also be selected.
Badge Position (Invisible Only)
For the invisible version, you can determine where you would like the reCAPTCHA badge to appear.
Version 3 Settings
Version 3 reCAPTCHAs sit silently on your website and require no interaction from your website visitors.
Action
Version 3 only requires that you enter an action name. This name is used to identify the action that initiated the reCAPTCHA and is used to cross reference calls in the reCAPTCHA admin pages.
You can just leave this field as is using the default value of:
ws_form/#form_id/load
… or you can enter your own. WS Form variables can be included in this setting.
The action must only contain the following characters:
- a-z
- A-Z
- / (Forward slash)
- _ (Underscore)
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.
Advanced
The advanced tab contains additional settings that provide further control over how a field is rendered.
Styles
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
Classes
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.
Restrictions
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.
Localization
Language
Choose the desired language for the reCAPTCHA.
Validation
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.
Breakpoints
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.