Contact Form
Use Contact Form to add a simple email form with configurable fields, spam protection, and post-submit actions.
Usage​
Use Contact Form to add a simple AJAX-powered email form with optional name, subject, email, phone, and message fields. It sends submissions through WordPress wp_mail(), supports a required terms and conditions checkbox, and can protect submissions with Google reCAPTCHA. After a successful submission, it can show a confirmation message or redirect visitors to another URL.
Use Contact Form on contact pages, landing pages, service pages, and other layouts that need a lightweight inquiry form without a separate form plugin. It fits straightforward single-step contact workflows where field requirements, submission handling, and styling stay simple.
Module Settings​
The Contact Form module settings control where submissions go, which fields appear, how the form looks, and how the form handles spam protection and successful submissions.
General Tab​
The General tab sets the recipient address, visible form fields, and post-submit behavior.
Send To Email Supports: Field Connections
The email address that receives form submissions. When left empty, the module sends notifications to the WordPress admin email.
Fields
The Fields section controls which contact form fields appear, the text used for their labels and placeholders, how labels display, and whether the form requires terms acceptance before submission.
Form Fields
Name Field Default: Show
Shows or hides the name input.
Name Field Placeholder
Name Field Placeholder Default: Your name
The text used for the name field label, placeholder, or both, depending on Show labels/placeholders.
Subject Field Default: Hide
Shows or hides the subject input.
Subject Field Placeholder
Subject Field Placeholder Default: Subject
The text used for the subject field label, placeholder, or both, depending on Show labels/placeholders. This field appears when Subject Field is set to Show.
Email Subject
Email Subject Default: Contact Form Submission; Supports: Field Connections
The subject line used for notification emails when Subject Field is set to Hide. Supports shortcodes.
Email Field Default: Show
Shows or hides the email input.
Email Field Placeholder
Email Field Placeholder Default: Your email
The text used for the email field label, placeholder, or both, depending on Show labels/placeholders. This field appears when Email Field is set to Show.
Phone Field Default: Hide
Shows or hides the phone input.
Phone Field Placeholder
Phone Field Placeholder Default: Your phone
The text used for the phone field label, placeholder, or both, depending on Show labels/placeholders. This field appears when Phone Field is set to Show.
Your Message Placeholder Default: Your message
The text used for the message field label, placeholder, or both, depending on Show labels/placeholders.
Show labels/placeholders Default: Show Both
Controls whether fields show placeholders only, labels only, or both. Selecting Show Labels Only or Show Both reveals the Labels group in the Style tab.
Terms and Conditions Checkbox Default: Hide
Shows or hides a required acceptance checkbox.
Checkbox Text
Checkbox Text Default: I Accept the Terms and Conditions
The text displayed next to the checkbox.
Terms and Conditions
Terms and Conditions Supports: Field Connections
The Terms and Conditions custom text uses the WordPress Classic Editor WYSIWYG, which lets you format text, add links, and include basic HTML. This content is displayed above the checkbox.
Success
The Success section configures the action that runs after a successful submission.
Success Settings
Success Action
Determines whether submission shows the built-in confirmation text, displays a custom message, or redirects to another URL. Options are None, Show Message, and Redirect.
Success Message
Success Message Default: Thanks for your message! We'll be in touch soon.; Supports: Field Connections
The confirmation message displayed after a successful submission when Success Action is set to Show Message.
Success URL
Success URL Supports: Field Connections
The destination URL used after a successful submission when Success Action is set to Redirect.
Style Tab​
The Style tab controls the appearance of labels, inputs, and the submit button.
Labels
This group is available when Show labels/placeholders is set to Show Labels Only or Show Both in the General tab.
Labels
Padding Supports: Responsive, Link Values
The inner spacing around each text label.
Color Supports: Field Connections
The text color of form labels.
Typography Supports: Responsive
The font settings for form labels.
Inputs
The Inputs section controls the appearance of text inputs and the message textarea.
Inputs
Padding Supports: Responsive, Link Values
The inner spacing of text inputs and the message textarea.
Color
The text and placeholder color of text inputs and the message textarea.
Typography Supports: Responsive
The font settings for text inputs and the message textarea.
Background Color Supports: Field Connections
The background color of text inputs and the message textarea.
Background Hover Color Supports: Field Connections
The background color used when text inputs and the message textarea are hovered.
Border
The border style, width, radius, and color for text inputs and the message textarea.
Border Hover
The border style used when text inputs and the message textarea are hovered or focused.
Button
The Button section controls the appearance of the submit button.
Button settings
Text Default: Send
The label displayed on the submit button.
Icon Supports: Field Connections
Adds an optional icon to the submit button.
DuoTone Primary Color
DuoTone Primary Color Default: #5b5b5b; Supports: Field Connections
For Font Awesome DuoTone icons only: the primary color applied to the icon.
DuoTone Secondary Color
DuoTone Secondary Color Default: #757575; Supports: Field Connections
For Font Awesome DuoTone icons only: the secondary color applied to the icon.
Icon Position
Icon Position Default: Before Text
Places the icon before or after the button text when an icon is selected.
Icon Visibility
Icon Visibility Default: Always Visible
Keeps the icon visible or fades it in on hover when an icon is selected.
Width Default: Auto
Sets the button width to Auto or Full Width.
Align
Align Default: Left; Supports: Responsive
The horizontal alignment of the button within its wrapper when Width is set to Auto.
Padding Supports: Responsive, Link Values
The inner spacing of the submit button.
Text Color Supports: Field Connections
The text color of the submit button.
Text Hover Color Supports: Field Connections
The text color of the submit button on hover and focus.
Typography Supports: Responsive
The font settings for the submit button text.
Background Color Supports: Field Connections
The default background color of the submit button.
Background Hover Color Supports: Field Connections
The background color of the submit button on hover and focus.
Background Style Default: Flat
Selects a Flat or Gradient background for the submit button.
Background Animation Default: Disabled
Enables or disables the transition between normal and hover background states.
Border Supports: Responsive
The border style, width, radius, and color of the submit button.
Border Hover Color Supports: Field Connections
The border color of the submit button on hover and focus.
Captcha Tab​
The Captcha tab configures Google reCAPTCHA for spam protection.
Set up your reCAPTCHA keys in the Google Admin Console. Each reCAPTCHA validation type requires its own unique site key and secret key pair.
For more information, see the reCAPTCHA v3 documentation.
reCAPTCHA Field Default: Hide
Shows or hides the Google reCAPTCHA field. Enabling it requires valid site and secret keys.
Validate Type
Validate Type Default: I'm not a robot checkbox (V2)
Selects the reCAPTCHA challenge mode: "I'm not a robot" checkbox (V2), Invisible (V2), and Invisible (V3). Checkbox and invisible flows use different Google API key pairs.
Action
Action
An optional action name passed to Google for v3 verification when Validate Type is set to Invisible (V3). Use letters, numbers, and underscores only.
Site Key
Site Key
The public site key from the Google reCAPTCHA Admin Console.
Secret Key
Secret Key
The private secret key from the Google reCAPTCHA Admin Console.
Theme
Theme Default: Light
The color scheme used for visible reCAPTCHA widgets.
Advanced tab​
The Advanced tab includes all the standard settings for margins, visibility, animations, and advanced HTML configurations.
See the Advanced tab section for more information.
Feature Guides​
Set up reCAPTCHA​
Use this workflow when the form needs Google reCAPTCHA protection.
- Open the Captcha tab and set reCAPTCHA Field to Show.
- Choose Validate Type based on the submission flow: "I'm not a robot" checkbox (V2), Invisible (V2), or Invisible (V3).
- Register the site in the Google reCAPTCHA Admin Console using the same validation type selected in the module.
- Use a different key pair for each validation type when the site uses both v2 and v3 forms.
- Paste the public key into Site Key and the private key into Secret Key.
- Set Theme to Light or Dark for visible widgets.
- If Validate Type is Invisible (V3), add an Action value that matches the verification flow for that form.
- Publish the page and submit the form from the front end.
- If verification fails, recheck the selected validation type, hostname, and key pair.