Jetpack Form Block

Build and share forms to collect leads, feedback, payments, and more with the power of Jetpack Forms.

Jetpack Blocks require the Block Editor (also referred to as the Gutenberg editor). If you’ve installed the Classic Editor plugin, you have a few options:

  • Deactivate the Classic Editor: Go to Plugins ? Installed Plugins in your WP Admin and deactivate the Classic Editor plugin.
  • Enable both editors: If you prefer flexibility, navigate to Settings ? Writing in your WP Admin (not the menu under Jetpack settings). Set Allow users to switch editors to Yes. You will only see these options if you have the Classic Editor plugin installed and active.

Some custom themes or plugins may prevent you from using the Block Editor. In that case, please contact the support team for the plugin or theme for further assistance.

For more details, see Using Blocks and the Classic Editor.

Jetpack’s Form feature is enabled by default. If you ever need to, you can disable Jetpack Forms by following the steps here.

If you’re using the Classic Editor, please see Contact Form (Classic Editor).

Add a Jetpack Form

The Form block is available on all Jetpack-connected sites and is free to use. To add a Form to any post or page, follow these steps:

  1. Type /form in the editor, or select the Form block from the block inserter.
  2. Choose from a pre-built form pattern to get started quickly (see below), or start with a blank form.
  3. Customize the form fields to fit your needs: remove, add, or reorder fields using the toolbar on each field.
  4. Make fields required or optional by toggling the * setting.
  5. To customize the Submit button, click it and replace the text directly.

Using the Jetpack Form Editor

You can also create and manage forms using the Jetpack Form Editor, a standalone interface outside of the block editor. It lets you build, organise, and publish forms directly from your WP Admin at Jetpack → Forms.

The form editor welcome guide

The first time you open the form editor, a five-step guide introduces the form building flow: adding fields, editing a field’s label and settings, choosing what happens after someone submits the form, and publishing and sharing the finished form.

To see the guide again at any time, click the Options icon (⋮) in the top-right corner of the form editor and select Welcome Guide.

The guide opens on a first visit to the form editor. It does not open if you have used the block editor before and already have a form of your own. It also does not open when you reach a form by clicking Edit form from a form on a post or page — only when you open the form editor directly from Jetpack → Forms.

Use form patterns to get started quickly

Jetpack Forms includes several pre-built form patterns, which are ready-made layouts you can insert and customize. Using a pattern is the fastest way to create a working form without building it from scratch.

Available form patterns

The following form patterns are included with Jetpack:

  • Contact Form: a general-purpose contact form for visitors to get in touch.
  • RSVP Form: collect event responses and attendance details.
  • Registration Form: gather sign-up information from new users or attendees.
  • Appointment Form: let visitors request or schedule appointments.
  • Feedback Form: collect opinions, reviews, or suggestions.
  • Lead Capture Form: capture potential customer information for follow-up.

How to insert a form pattern

You can access form patterns in two ways:

  1. From the block inserter: type /form in the editor. A list of available form patterns will appear, then select the one that best fits your needs.
  2. From the form setup screen: when you add a new Form block, Jetpack displays a pattern picker showing all available layouts. Click any pattern to insert it instantly.

Once inserted, every part of the pattern is fully editable: you can add, remove, or rearrange fields, change labels, and adjust settings to match your use case.

Form fields available inside the Jetpack Form Block

The Form block has several blocks that add fields to your form. Available form fields include:

  • Custom HTML Field: Allows site owners to insert custom HTML within the form. This can be used for adding custom formatting, embedded content, or additional form elements that are not natively available.
  • Date Picker: Allows users to pick a date from a calendar, making it useful for appointment scheduling. The expected date format is shown below the input.
  • Dropdown Field: Presents a list of options in a drop-down menu, useful for structured responses with multiple choices.
  • Email Field: Captures a user email. It requires users to enter a valid email address, making it useful for responding to inquiries.
  • File Upload Block: Allows users to upload files with their form submissions.
  • Hidden Field: Stores extra information that is sent with the submission but not visible to the user. It can help track where submissions come from or pass data for integrations and automation.
  • Multi-line Text Field: Provides a multi-line text area for longer messages or descriptions.
  • Multiple Choice (Checkbox): Allows users to select one or more options.
  • Name Field: Captures the name of the visitor and appears as a single-line text input.
  • Number Input Field: Provides a single-line input for numerical values.
  • Phone Number Field: Captures phone numbers for direct communication. Phone fields in form responses are clickable, and includes a country code selector. On supported devices, this allows you to initiate a call or open your default phone application directly.
  • Rating Field (stars and/or hearts): Enables customers to leave ratings as part of form submissions, e.g. when reviewing products or services. 
  • Single Choice (Radio): Enables users to select one option from a predefined list. You can also include an optional “Other” choice with a text input field, allowing users to provide a custom response if none of the predefined options apply. To enable this, select the Single Choice (Radio) field in the editor, open the block settings in the right sidebar, and toggle on the Include “Other” option setting.
  • Slider Field: Supports a wide range of use cases, such as specifying a budget in quotation requests, setting distance or percentage ranges, or offering alternative ways to rate items beyond the standard rating field.
  • Terms Consent: Helps ensure compliance by requiring users to agree to terms before submission.
  • Text Input Field: Provides a single-line input for short text responses.
  • Time Input Field: Provides a single-line input for a time of day, useful for booking and scheduling forms.
  • Website Field: Provides a single-line input for website URL, which is useful for collecting business or blog links.

In this video, you can see how to add a dropdown field to your form:

HTML tags limitations

Not all HTML tags are allowed in the form block for security reasons. These are some of the tags that are not allowed: 

  • header
  • embed
  • frame
  • iframe
  • form
  • input
  • object
  • textarea
  • script
  • style
  • link

Leverage Jetpack AI to build your own form

Jetpack AI-powered functionality of the Form Blocks is a part of Jetpack AI Assistant suite.

Jetpack AI offers you 20 free requests to get started. For more information about upgrading, please refer to our detailed Usage limitations and upgrades guide.

How use Jetpack AI to construct a form

  1. In your form block, find the field that says Ask Jetpack AI to create your form. (Click on the Sparkles ✨ icon in the block toolbar if you don’t see it).
  2. Write a brief description of the information you want to collect.
  3. Click Generate.

The Form block will now pre-fill with the relevant form fields.

Here are examples of prompts that you could use to create your form:

  • Add a registration form that collects name, email, and phone number.
  • Create a form with name and email, also, ask for the T-shirt size from S to XXL.

You can also use Jetpack AI to edit an existing form, whether the form was initially created with AI or from a pattern. For example:

  • Add a block to collect feedback with options from bad to great.
  • Move the phone number field before the email field.
  • Make all fields required.

In this video, you can see the Jetpack AI form integration in action:

Preview and test a form

You can preview any form and submit test responses to verify that everything works end-to-end before visitors interact with it. Test responses are tracked separately from real submissions, so they won’t mix into your data.

For step-by-step instructions, see Preview and test a form in the Form Editor guide.

Adjust Block settings

After adding a Form block, you can specify manage what happens when someone fills out the form:

Choose where to be notified

Email Notifications

The default email address used by a Jetpack Form is the site administrator’s email address (Form responses are emailed to a recipient you choose. If you do not choose one, the recipient is worked out automatically from where the form sits on your site.

To set a recipient:

  1. Select the Form block, and open Form notifications in the block settings sidebar.
  2. Type an address into Send email notifications to.
  3. To notify several people, separate each address with a comma.

The field starts empty, with a greyed-out address shown as a placeholder. That placeholder is where responses will go if you leave the field empty. It is a preview of the automatic recipient, not a saved value.

Help text under the field names the rule in use:

  • On a post or page, responses go to the post author.
  • In a widget, a block template, or a template part, responses go to your site administrator’s address, set at Settings → General → Administration Email Address.
  • In the standalone form editor, responses go to the author of the page where the form appears.

On a post or page, responses go to the post author only while that author still has an email address, is still a member of your site, and can still edit the post. If any of those stops being true, responses go to your site administrator’s address instead.

Typing an address saves it to the form. Clearing the field returns the form to the automatic recipient.

You can type the same address the placeholder shows. Saving it pins responses to that address, so they keep arriving there even if the post author changes later. An empty field follows whoever the post author is at the time.

If this field used to show an address and now looks empty, nothing about your form has changed. That address was never saved to your form; it was always worked out automatically, and it still is. Responses go exactly where they went before.

Push Notifications

You can receive push notifications for form responses by selecting the Enable notifications for responses. You are able to specify which Jetpack-connected users will receive notifications.

You can find more information on configuring push notifications in Jetpack, including whether to receive them in the Jetpack app or browser.

Responses storage

You can choose not to save form submissions in the WP Admin. You can do it by accessing the Responses storage settings in the Form’s Block panel and toggle off the setting, which is enabled by default.

Submission settings

The Action after submit setting controls what the user sees after they submit the form. The options are:

  • Show a summary of submitted fields, with a customizable message heading.
  • Show a custom text message.
  • Redirect to another webpage.

The summary shows the heading you set, each submitted field with its answer, and a back button that returns the visitor to the page the form is on. Answers render according to their field type: ratings show stars, website addresses become links you can click, phone numbers become links that start a call, file uploads show the file name and size, and image select fields show thumbnails.

Individual form field settings

You can also customize the settings for each individual form field. To do so, click on the field. You will see options to:

  • Mark the field as required
  • Modify the width of the form field (available values are 25%, 50%, 75% and 100%)
  • Change the background color (solid or gradient) and text color

Add help text to a field

Help text is a short hint that appears below a field’s input on your published form. Use it to explain what to enter — for example, why you are asking for a phone number, or what the ends of a slider mean.

Screen readers announce help text after the field’s label, so adding it does not change what the field is called.

To add help text to a field:

  1. Select the field in the editor.
  2. Type into the “Add help text…” placeholder that appears below the input, or open the block settings sidebar and enter your text in the Help text box under Field settings.
  3. Click Save or Publish to keep your changes.

Both places write the same text, so use whichever you prefer. To remove help text, clear the box.

Help text is plain text. It cannot contain links, bold or italic formatting, or line breaks.

These fields support help text:

  • Text Input
  • Name
  • Email
  • Website
  • Phone Number
  • Multi-line Text
  • Number
  • Date Picker
  • Time input
  • Dropdown
  • Slider

These fields do not support help text:

  • Rating
  • Multiple Choice (Checkbox)
  • Single Choice (Radio)
  • Terms Consent
  • File Upload
  • Hidden
  • Custom HTML

Where the date format appears

The Date Picker field shows its expected format, such as YYYY-MM-DD, below the input rather than inside the field label. In earlier versions of Jetpack the format was added to the end of the label, so a field named “Birthday” read “Birthday (YYYY-MM-DD)”. The label is now only the name you gave the field.

The hint follows the field’s Date Format setting, so changing the format changes the text below the input.

If you add help text to a Date Picker field, the help text appears first and the format follows it on the same line.

Customize the submit button

You can change the following settings for the submit button:

  • Button text
  • Color of the button (solid or gradient)
  • Color of the text
  • Border radius
  • Width of the button (25%, 50%, 75%, 100%, or a custom value in pixels)
  • Button alignment (left, right, or center justification)

Customize the subject field in notification emails

Jetpack offers an option to change the subject of the email sent to you after each form submission. You can add tokens to the subject field, like {city}, and Jetpack will replace the token with the value of the “City” form field (case insensitive, just make sure that the words match).

Managing forms and integrations

After publishing your Jetpack Form, you’ll be able to review and manage submissions right inside your WP Admin. Just head to Jetpack → Forms → Responses in the left-hand menu.

When you have a response open, keyboard shortcuts let you move between responses and mark them as spam or trash without a mouse.

See Managing Contact Form Responses and Integrations for the full list and more features to view, handle, and export your form responses.

Multistep Forms block

You can use Multistep Forms to split a long form into smaller, manageable sections, guiding visitors through each step one at a time instead of displaying all the fields at once.

You can head to its dedicated support page to read more about how to set it up and customize it.

Still need help?

Please contact support. We’re happy to advise.

Privacy Information

The Form Block is activated by default. It can be deactivated/reactivated at any time by following the guide to control Jetpack features on one page.

Data Used
Site Owners / Users

For activity tracking (detailed below): IP address, WordPress.com user ID, WordPress.com username, WordPress.com-connected site ID and URL, Jetpack version, user agent, visiting URL, referring URL, timestamp of event, browser language, country code.
Site Visitors

If Akismet is enabled on the site, the contact form submission data (IP address, user agent, email address, site URL, and comment) is submitted to the Akismet service (also owned by Automattic) for spam checking. The actual submission data is stored in the site’s database on which it was submitted and is emailed directly to the owner of the form (i.e., the site author who published the page on which the contact form resides). This email will include the submitter’s IP address, timestamp, name, email address, website, and message.

The IP address is included as an abuse prevention measure. And for sites using Akismet, it is required to provide proper spam defense.
Activity Tracked
Site Owners / Users

We track when and by which user the feature is activated and deactivated and when CSVs or Google Sheets are exported from the Feedback forms page.
Site Visitors

None.
Data Synced (Read More)
Site Owners / Users

We sync a single option that identifies whether the feature is activated.
Site Visitors

We sync post and post-meta data associated with a user’s contact form submission. If Akismet is enabled on the site, the IP address and user agent originally submitted with the comment are also synced, as they are stored in post meta.