How do I customize the recaptcha field?

Article Last Updated: January 1, 2016

In version 6.0.3.2 we’ve added some additional shortcode parameters which allow you to customize the reCaptcha field associated with your list.

The new shortcode parameters are as follows:

  • recaptcha – Toggle visibility of the reCaptcha field on a per form basis. Options: 1 or 0. Default: 1. Note: To toggle the recaptcha on a per form basis you’ll need to enable recaptcha globally on the settings page. You can then show/hide as needed.
  • recaptcha_lang – Adjust the language of each reCaptcha field individually. Defaults to the language set for your site inside of ‘Settings > General’. (See all available languages and associated language codes here)
  • recaptcha_type – Set the type of reCaptcha this is. Options: Image or Audio. Default: Image.
  • recaptcha_theme – Set the theme for this reCaptcha field. Options: Light or Dark. Default: Light.
  • recaptcha_size – Toggle the size of this reCaptcha field. Options: Normal or Compact. Default: Normal. (Note: Compact is best for mobile devices)
  • recaptcha_data_callback – Advanced – Fire off a custom JavaScript callback function when the user successfully checks off the reCaptcha field.
  • recaptcha_expired_callback – Advanced – Fire off a custom JavaScript callback function when the reCaptcha field expires and needs to be refreshed.

Example

Here is an example shortcode with all of the possible recaptcha shortcodes being used.

	

The above will display something similar to:
recaptcha-dark-screenshot

Developers

Developers can also make use of the built in filter, `yikes-mailchimp-recaptcha-parameters`, which allows you to alter any of the parameters listed above on a per form basis. For a working example check our Developer Documentation.