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.
Add a Google reCAPTCHA​
Google reCAPTCHA blocks automated spam submissions on the Contact Form and Subscribe Form modules. You configure it in the module's Captcha tab using a key pair from Google. Beaver Builder supports three validation types, so you can choose between a visible checkbox and background scoring.
Before you begin​
You need a few things in place before you configure the module.
- A published page that contains a Contact Form or Subscribe Form module.
- A Google account with access to the reCAPTCHA admin console.
- The domain name where the form runs, so you can register it with Google.
Each validation type uses a different key pair. If you switch a form between the checkbox and an invisible type, register new keys in the admin console and update the module.
Choose a reCAPTCHA type​
Pick the validation type that fits how you want visitors to verify themselves. You select the matching type later in the module's Validate Type setting.
- "I'm not a robot" checkbox (v2): Visitors check a box, and Google may show an image challenge. This is the most visible option and the only one where the Theme setting (light or dark) changes the widget's appearance.
- Invisible (v2): No checkbox appears. Verification runs when the visitor submits the form, and Google shows a challenge only when a submission looks suspicious. A reCAPTCHA badge displays in the corner of the page.
- Invisible (v3): Runs silently and returns a score instead of showing a challenge. Beaver Builder accepts submissions that score 0.5 or higher. This type supports an optional Action label and also displays a badge.
Google requires the reCAPTCHA badge on invisible (v2 and v3) forms, or a text disclosure that links to Google's Privacy Policy and Terms of Service.
Get your reCAPTCHA keys​
Register your site with Google to generate the site key and secret key.
- Sign in to the Google reCAPTCHA admin console.
- Add a label so you can identify the site later.
- Select the reCAPTCHA type that matches the validation type you chose: reCAPTCHA v2 "I'm not a robot" Checkbox, reCAPTCHA v2 Invisible badge, or reCAPTCHA v3.
- Add your domain. Omit
http://,https://, and any path. - Accept the terms and submit the form.
- Copy the Site Key and Secret Key. Keep the secret key private.
Add reCAPTCHA to your form​
Enter your keys in the module to turn on protection.
- Open the form module's settings and select the Captcha tab.
- Set reCAPTCHA Field to Show.
- Set Validate Type to the type you registered with Google.
- Paste your Site Key and Secret Key.
- For the checkbox type, set Theme to Light or Dark.
- For Invisible (v3), optionally enter an Action label.
- Save the module and publish the page.
Test your form​
Confirm the protection works from the front end after publishing.
- Open the published page in a logged-out browser or private window.
- Complete the form and submit it.
- For the checkbox type, confirm the widget appears and must be checked before the form sends.
- For invisible types, confirm the badge appears and the form submits without a challenge under normal use.
- Verify the notification email arrives at the configured address.