Marketing · Gutenberg
Multi-Step Form block for WordPress
A wizard-style multi-step lead capture form with step indicator, per-step fields, and success message.
Get Blockenberg
Free Gutenberg block in Blockenberg. The inspector controls and front-end behavior on this page come from this block’s source, not a shared stub.
What it actually does
A wizard-style multi-step lead capture form with step indicator, per-step fields, and success message.
Inspector panels on this block: Form Settings, Button Labels, Success Screen, Card & Input Style, Form Steps & Fields. Those titles come from index.js, not from a shared template.
Behavior controls: “Progress style” options: Step circles, Progress bar, Dots; “Field type” options: Text, Email, Phone, Textarea, Select.
Where to find it
Gutenberg inserter → Marketing → search “Multi-Step Form” (block name `blockenberg/multi-step-form` in block.json). Style it in the sidebar after insert.
How to use Multi-Step Form block for WordPress
- Install Blockenberg. Install from WordPress.org and activate the plugin.
- Insert the block. Edit a page, click +, search for “Multi-Step Form”, insert it. Category: Marketing.
- Configure inspector controls that exist on this block. Open Form Settings. Set “Max width (px)”, “Progress style”, “Show step titles”, “Show descriptions”.
- Check the published page. The view script reads HTML data attributes: data-action, data-progress, data-submit-label, data-total-steps. The block editor preview may not run the same view script.
Inspector controls from this block’s code
| Control | What the code does |
|---|---|
| Max width (px) | Numeric range control in the inspector. Range 400–900. block.json default: 580. Saved as `formMaxWidth`. |
| Progress style | Select control; the chosen value is saved on the block. Options: Step circles; Progress bar; Dots. block.json default: steps. Saved as `progressStyle`. |
| Show step titles | On/off toggle in the inspector. On by default. Saved as `showStepTitles`. |
| Show descriptions | On/off toggle in the inspector. On by default. Saved as `showStepDescriptions`. |
| Show step numbers | On/off toggle in the inspector. On by default. Saved as `showStepNumbers`. |
| Show step icons | On/off toggle in the inspector. On by default. Saved as `showStepIcons`. |
| Next button | Text field in the inspector. block.json default: Continue →. Saved as `btnNextLabel`. |
| Back button | Text field in the inspector. block.json default: ← Back. Saved as `btnPrevLabel`. |
| Submit button | Text field in the inspector. block.json default: Submit Request. Saved as `btnSubmitLabel`. |
| Success Screen — Title | Text field in the inspector. block.json default: 🎉 Thank you!. Saved as `successTitle`. |
| Message | Multiline text field in the inspector. block.json default: We've received your request and will be in touch within 24 hours.. Saved as `successMessage`. |
| Card radius (px) | Numeric range control in the inspector. Range 0–32. block.json default: 20. Saved as `cardRadius`. |
| Card padding (px) | Numeric range control in the inspector. Range 16–64. block.json default: 40. Saved as `cardPadding`. |
| Input radius (px) | Numeric range control in the inspector. Range 0–16. block.json default: 8. Saved as `inputRadius`. |
| Input padding V (px) | Numeric range control in the inspector. Range 6–20. block.json default: 12. Saved as `inputPaddingV`. |
| Button radius (px) | Numeric range control in the inspector. Range 0–99. block.json default: 8. Saved as `btnRadius`. |
| Step circle (px) | Numeric range control in the inspector. Range 30–64. block.json default: 44. Saved as `stepCircleSize`. |
| Step label (px) | Numeric range control in the inspector. Range 10–16. block.json default: 12. Saved as `stepLabelSize`. |
| Field label (px) | Numeric range control in the inspector. Range 12–18. block.json default: 14. Saved as `labelSize`. |
| Input text (px) | Numeric range control in the inspector. Range 13–20. block.json default: 15. Saved as `inputSize`. |
| Button text (px) | Numeric range control in the inspector. Range 13–22. block.json default: 15. Saved as `btnSize`. |
| Padding top (px) | Numeric range control in the inspector. Range 0–200. block.json default: 64. Saved as `paddingTop`. |
| Padding bottom (px) | Numeric range control in the inspector. Range 0–200. block.json default: 64. Saved as `paddingBottom`. |
| Step title | Text field in the inspector. |
| Description | Text field in the inspector. |
| Field type | Select control; the chosen value is saved on the block. Options: Text; Email; Phone; Textarea; Select; Radio; Checkbox. |
| Label | Text field in the inspector. |
| Placeholder | Text field in the inspector. |
| Options (one per line) | Multiline text field in the inspector. |
| Required | On/off toggle in the inspector. |
What the front-end script actually does
- The view script reads HTML data attributes: data-action, data-progress, data-submit-label, data-total-steps.
When this is the right block
- A wizard-style multi-step lead capture form with step indicator, per-step fields, and success message — that is the job of Multi-Step Form, not a generic content block.
- Use it when you need the editor control labeled “Max width (px)”, which exists on this block’s inspector.
- It matches pages about form, multi step, wizard.
- Inserter grouping: landing pages, campaign sections, and conversion layouts.
Notes from the implementation
viewScript: this folder’s frontend.js is enqueued on the front end for this block.
FAQ
How do I add the Multi-Step Form block in WordPress?
Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Multi-Step Form”. It sits under Marketing. After insert, open Form Settings and set “Max width (px)”, “Progress style”, “Show step titles”, “Show descriptions”.
What makes Multi-Step Form different from other Blockenberg blocks?
A wizard-style multi-step lead capture form with step indicator, per-step fields, and success message. Inspector labels on this block include “Max width (px)”, “Progress style”, “Show step titles”, “Show descriptions”.
Is the Multi-Step Form Gutenberg block free?
Yes. Multi-Step Form ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.
Can I style Multi-Step Form to match my theme?
Yes. Blockenberg’s shared typography and color panels apply here, plus any block-specific style controls listed on this page (panels: Form Settings, Button Labels, Success Screen, Card & Input Style).
Related marketing blocks
Split Form
Side-by-side lead generation section — content (heading, text, feature bullets) on one side and a fully configured email / sign-up form on the other.
Booking Form
Appointment booking form with calendar date picker, time slot selection, service type and confirmation message.
How It Works
Numbered process steps section — show a 3-6 step sequence with large step numbers, icons, titles, descriptions, and optional connectors. Perfect for onboarding flows and feature walkthroughs.
Launch Waitlist
Product or service launch section with live countdown timer, email waitlist form, feature teasers, and social proof. For pre-launch landing pages.
Product Tour
An interactive product walkthrough with numbered steps, descriptions and screenshots. Tabs-style navigation — perfect for onboarding flows and feature showcases.
Social Proof Popup
Floating FOMO notification popups that cycle through social proof entries like purchases, signups, and reviews.
Get Blockenberg
Install Blockenberg from WordPress.org, then insert Multi-Step Form from the Gutenberg inserter.