Welcome to the documentation for Forming Forms, the block editor form builder for WordPress by BeautifulPlugins. A form is a block: you add the Form block to a post or page, nest field blocks inside it, and publish. There are no shortcodes and no separate builder screen. Everything that happens after a submission (entries, exports, settings) is managed under Forming in your admin menu.
New here? Start with Installation and then follow the Getting Started guide. It takes you from a fresh install to a working, spam-protected contact form in about five minutes.
Want to see it first? Fill in real forms and explore the block editor setup on the Forming Forms live demo.
Setup
- Installation: requirements, installing, updating and uninstalling.
- Getting Started: build and publish your first contact form.
Building Forms
- The Form Block: the parent block and its settings panels: Form, Notifications, After submit, Spam protection and Storage.
- Field Blocks: the 12 free field types, their settings, choice options and dynamic hidden values.
- Validation: browser and server checks, per-field rules and custom error messages.
- Styling & Layout: block supports, field widths, block gap and the CSS classes the plugin outputs.
- Reusing Forms: synced patterns, template parts and widget areas.
- Accessibility: the markup Forming Forms generates, and how to keep your forms usable.
Submissions
- Email Notifications: recipients, subject, From and Reply-To, test emails and fixing delivery problems.
- Spam Protection & CAPTCHA: the honeypot, time-trap, rate limit, Akismet, reCAPTCHA, hCaptcha and Turnstile.
- Entries & Storage: the Entries inbox, CSV export, privacy tools and how entries are stored.
The Forming Admin
- Dashboard, Forms, Settings & Tools: every screen under the Forming menu and every global setting.
Forming Pro
- Forming Pro: what Pro adds, installing it and managing your license.
- Pro Field Blocks: all 16 premium fields and their settings.
For Developers & Help
- Developer Reference: the field type registry, PHP and JS hooks, entry meta, REST endpoints and WP-CLI.
- FAQ & Troubleshooting: answers to common questions and fixes for common problems.
Can’t find what you need?
Search this documentation first, because most answers are a page away. If you’re still stuck, ask on the WordPress.org support forum or, if you have a Pro license, through BeautifulPlugins support. Include your WordPress version, the plugin version, your theme, and what you expected to happen. Forming → Tools → System status has a Copy for support button that gathers most of this for you.