Contact Form 7 Multi-Step Forms

Contact Form 7 Multi-Step Forms

توسط

Add multi-step forms to Contact Form 7 with full data persistence between pages and a single email on final submission. Upgrade to Pro to submit 5MB forms through sessionStorage, conditional step-skipping, and priority support.

The Original Contact Form 7 Multi-Step Plugin

Since 2012, this has been the go-to multi-step solution for Contact Form 7 users. It’s built for reliability and trusted on thousands of sites. Split your CF7 form across multiple pages, preserve data between steps, and send one complete email at the end.

It’s been running quietly on thousands of sites through every major WordPress and CF7 release. If you need multi-step forms with CF7, this is where most people start.

See it in action at https://webheadcoder.com/contact-form-7-multi-step-form/

Requires Contact Form 7 (5.2 or above) by Rock Lobster Inc. (Takayuki Miyoshi).

Usage

  1. Create one page or post for each step in your multi-step form process. If you have 3 steps, create 3 pages/posts. You will need the urls to these when creating your forms.

  2. Create a Contact Form 7 form.

  3. Place your cursor at the end of the form.

  4. On the “Form” tab of the Contact Form 7 form, click on the button named “multistep”.

  5. In the window that pops up, check the checkbox next to “First Step” if this is the first step of your multi step forms. If this is your last step in the multi step forms, check the “Last Step” checkbox. All other checkboxes are optional.

  6. The Next Page URL is the url that contains your next form. If this form is the last step, you can leave the URL field blank.

  7. Click “Insert Tag”

  8. Save your completed form and place the form’s shortcode into the appropriate Page/Post you created in step 1.

  9. Repeat for each form in your multi-step form process.

  10. On the last step, you probably would want to send an email. Make sure to check the “Send Email” checkbox in step 5. On the Mail Tab, simply enter the mail-tags as you normally would. For example if your first form has the field your-email you can include [your-email] in the Mail tab on your last form. Note: CF7 will see this as an error because your-email may not be displayed on the current form. You can safely ignore this error.

Multistep Tag Options

  • Name – The name of this multistep form-tag. This is required, but is currently not being used.

  • First Step – Besides marking the first step of your multistep forms, this allows any form to act as the first step and show when no previous data has ben submitted. This is useful when you want some users to skip the first step.

  • Last Step – Besides marking the last step of you multistep forms, this clears the data from user’s browsers. Once they submit this form they won’t see their data populating the forms anymore.

  • Send Email – If this is checked the form will send an email like a normal Contact Form 7 submission.

  • Skip Save – If you use Flamingo or CFDB7 to save submissions to the database this prevents saving this form submission.

  • Next Page URL – This is the URL your users will go to after the form is submitted.

    [multistep multistep-123 last_step send_email skip_save “/thank-you”]

Additional Tags

[multiform "your-name"]

The multiform form-tag can be used to display a field from a previous step. Replace your-name with the name of your field. This is only for use on the Form tab, this tag will not work in the Mail tab.

[previous "Go Back"]

The previous form-tag can be used to display a button to go to a previous step. Replace Go Back with text you want to show in the button.

Messages Tab
When a visitor to your site visits the 4th step in your multi step form without filling out the 1st step, the message “Please fill out the form on the previous page.” will be displayed. You can change this on each form in the Messages tab.

What this plugin DOES NOT do:

  • This plugin does not support file uploads on every form. If you need to use file uploads make sure to place it on the last step.

  • This plugin does not load another form on the same page. It only works when the forms are on separate pages. Many have asked to make it load via ajax so all forms can reside on one page. This plugin does not support that.

PRO Version
If you expect to have a lot of data submitted through your multi-step forms, the Pro version may be able to help you better. The PRO version uses Session Storage so it is able to handle roughly 1,000 times more data for your multiple forms. In total it can handle about 5MB vs 4KB in the free version. Currently the Pro version REQUIRES the WordPress REST API and Contact Form 7 AJAX Submission to be enabled.

Another feature the Pro version offers is the ability to skip steps with the “Contact Form 7 – Conditional Fields plugin”. Learn more here.

راهنمای نصب برای این آیتم موجود نیست.

سوالات متداول

The Next button doesn’t show up

You still need a standard Contact Form 7 submit button on each step.

Add a submit tag like this:
[submit “Next”]

Also note: multistep is a hidden field. If content appears to disappear right after it, place the tag at the end of the form (or add a line break after it).

I keep getting the “Please fill out the form on the previous page” message. What’s wrong?

This message usually means step-tracking data is missing. Check these first:

  1. Caching is blocking cookies. Exclude cookies named cf7* from cache behavior.
  2. Form step URLs do not match protocol/domain. Every step must use the same domain and protocol. For example, if your first page uses https like https://webheadcoder.com, your second page cannot use http:// or a subdomain of that.
  3. The first form is missing first_step in its multistep tag, for example:
    [multistep multistep-123 first_step “/your-next-url/”]
Why are no values being passed from one form to the next form?

If the page reloads on submit instead of using AJAX, Contact Form 7 JavaScript is not running correctly or the REST API is disabled.

Use Contact Form 7’s troubleshooting guide:
https://contactform7.com/why-isnt-my-ajax-contact-form-working-correctly/

How can I show a summary of what the user entered or show fields from previous steps?

[multiform “your-name”]
Use the multiform tag to display values captured on earlier steps. Replace your-name with your field name.

My form values aren’t being sent in the email. I get [multiform “your-name”] instead of the actual person’s name.

multiform is for the Form tab only.

For email content in the Mail tab, use standard CF7 mail-tags such as [your-name], not [multiform "your-name"].

Also confirm the last step includes the multistep tag.

Can I have an email sent on the first step of the multi-step forms?

Yes. Enable “Send Email” in the tag generator, or add send_email directly in the tag:
[multistep multistep-123 first_step send_email “/your-next-url/”]

My forms are not working as expected. What’s wrong?

Start with these checks:

  • Confirm every step includes a multistep tag.
  • Look for JavaScript errors from other plugins or themes that may block CF7 scripts.
  • Temporarily deactivate other plugins and test again to isolate conflicts.
Why “place your cursor at the end of the form” before inserting the multistep tag?

multistep is a hidden field and intentionally adds minimal spacing. If another element is placed immediately after it, that element may appear hidden.

To avoid this, insert multistep at the end of the form or add a line break after the tag.

How do I get Flamingo or CFDB7 to not save every form?

Use the “Skip Save” option, or add skip_save in your multistep tag:
[multistep multistep-123 skip_save “/your-next-url/”]

When checkbox fields are left unchecked they appear as [field-name] in the email. How do I resolve this?

Unchecked checkboxes are not submitted, so the final step may not know that field exists.

Add a hidden field with the same name on the last step, for example:
[hidden field-name]

This ensures the final step submits either the saved value or a blank value.

تصویری برای این آیتم موجود نیست.
نظری برای این آیتم موجود نیست.
0 0 رای ها
امتیازدهی
اشتراک در
اطلاع از
0 نظرات
قدیمی‌ترین
تازه‌ترین بیشترین رأی
هیچ نسخه‌ای برای این آیتم موجود نیست.
★★★★★
★★★★★
4.2 /5 (49 نظر)

قیمت:

رایگان

نگارش

آخرین انتشار

10 اردیبهشت 1405

آخرین بروزرسانی

4 ماه پیش

نصب های فعال

50,000+

نگارش وردپرس

وردپرس 4.7+

تست شده از نسخه

وردپرس 6.9.4

نگارش PHP

-

نسخه ها

0 نسخه