Description
Promptless Forms is a lightweight WordPress form plugin built for developers and design-system-aware sites. Configure forms via JSON in the admin UI or via PHP code, render them with a shortcode, and send submissions to webhooks, email, or both.
Core features
- JSON or PHP form configuration
- 13 field types: text, email, tel, textarea, select, radio, checkbox, file, hidden, message, section, date, and address (with Google Places autocomplete)
- Multi-step forms with progress indicators
- Conditional field visibility based on other field values
- Column layouts (1/2, 1/3, 2/3, 1/4, 3/4) and section grouping
- Webhook delivery with HMAC-SHA256 signing and SSRF protection
- Email notifications with template variables
- Spam protection: honeypot, timing check, and rate limiting
- CSV export of form entries
- File upload handling with magic-byte verification
Integration
When the Promptless WP plugin is active, Promptless Forms automatically inherits design tokens (colors, typography, border radius) from the global brand settings. Forms also support dark mode through Promptless’s theme_variant setting. The plugin works fully standalone with sensible defaults when Promptless WP is not active.
For developers
- Stable hook surface for extending behavior (
pforms_submission_complete,pforms_webhook_payload,pforms_field_display_value, etc.) - Connector REST API for external integration (default-disabled, opt-in via admin toggle)
- WordPress coding standards compliant
- Transactional InnoDB storage for entries
External Services
This plugin can optionally connect to external services. Each service is opt-in and requires explicit configuration by a site administrator.
Webhooks (when configured per-form):
Submission data is POSTed to a URL of your choosing. The URL, request payload, and signing secret are all configured by the site administrator on a per-form basis. No data is sent until a webhook URL is configured.
Google Places API (when the Address field is used):
The Address field uses Google’s Places API to provide address autocomplete. Requires a Google Places API key configured in the plugin settings. Address queries are sent to Google when users type in the field. See Google’s Places API Terms and Privacy Policy.
Twilio API (when configured):
The optional Twilio module sends SMS messages and handles missed-call text-back workflows. Requires Twilio account credentials configured in the plugin settings. Phone numbers and message content are sent to Twilio for delivery. See Twilio’s Terms of Service and Privacy Policy.
Claude Cowork Connector (default-disabled, opt-in):
The Connector exposes a REST API allowing AI agents (such as Anthropic’s Claude Cowork) to manage forms via WordPress Application Passwords. Default state is disabled. To enable, an administrator must explicitly toggle the connector on in Form Entries → Connector and generate a per-user Application Password. No external requests are made by the connector — it only responds to authenticated incoming requests.
Installation
- Upload the plugin files to
/wp-content/plugins/promptless-forms/or install through the WordPress Plugins screen. - Activate the plugin through the Plugins screen in WordPress.
- Go to Form Entries in your WordPress admin menu to create your first form.
For developer documentation including JSON configuration examples, hook reference, and integration patterns, see the plugin’s GitHub repository.
FAQ
Does this plugin require Promptless WP?
No. Promptless Forms works fully standalone with sensible default styling. When Promptless WP is active, forms automatically inherit your brand colors, typography, and design tokens.
How do I display a form on a page?
Use the shortcode [promptless_form id="your-form-id"] on any post, page, or widget. The id matches the form ID you set when creating the form in the admin.
Can I send form submissions to Zapier, Make, or Google Sheets?
Yes. Each form can be configured with a webhook URL in the Forms Manager. Submissions are signed with HMAC-SHA256 for verification on the receiving end. The plugin supports preset configurations for common destinations including Zapier, Make, and Google Sheets (via Apps Script).
Does the plugin support multi-step forms?
Yes. Define a steps array in your form configuration and assign each field to a step via the step attribute. The plugin renders a progress indicator and handles step navigation automatically.
Where are uploaded files stored?
Uploaded files are added to the Media Library in the normal uploads folder (/wp-content/uploads/YYYY/MM/) under a random name, so they cannot be guessed. Before a file is saved, it waits in a protected holding folder while it is checked: the extension must be allowed, the real file type must match, the file header must be right, images must open, and the file may not contain PHP code. SVG files are also checked for scripts.
Changelog
1.14.0
- Changed: faster pages. The form’s stylesheet and script are served minified, and the script loads deferred.
- Changed: a page whose only forms are in closed popups no longer waits for the form stylesheet before it first paints. Popups still open fully styled.
- Changed: a multi-step form’s progress shows as steps or a bar from the first paint, instead of switching after the page appears.
- Fixed: without Promptless WP, the default accent, field borders and dark-mode text now meet WCAG contrast. Standalone forms look slightly different: a deeper indigo and darker borders.
- Fixed: links in status messages stay readable inside Promptless WP sections and the Promptless theme.
- Fixed: placeholder contrast on dark sections, and focus rings in older browsers.
1.13.0
- Added: open and close dates and an entry limit per form (“availability” in the form’s settings), with your own closed message and a message shown before the form opens. Dates use the site timezone; a date without a time closes at the end of that day.
- Added: the rules are enforced on the server when a form is submitted, so a page cached while the form was open still gets the closed message and nothing is saved. A closed form shows its message instead of the form.
- Added: the entry limit holds when several people submit at once. Spam never takes a place and deleting entries never frees one.
- Added: the Forms list shows each form’s status (open, or closed and why, with places taken), with an Adjust count control to correct or reset a form’s count.
- Added: the AI connector can set, change and read these rules, and refuses test submissions to closed forms.
- Fixed: the AI connector’s test submit now returns which fields failed validation.
1.12.3
- Fixed: a clear, high-contrast focus outline on every field, including fields showing an error, in the site’s brand colour (or the text colour when that is too light).
- Fixed: on a multi-step form’s last step, Submit now lines up with Previous.
- Fixed: radio buttons and checkboxes use the site’s brand colour, and the file field’s button matches the form’s buttons.
- Fixed: an empty or invalid sender address no longer sends notifications as “WordPress”; the site’s admin email is used with your sender name, and an invalid address is refused when the form is saved.
- Fixed: the entries list now shows who sent each entry (name and email) instead of the first two answers, and the entry page no longer lists the internal form version as an answer.
- Fixed: notification emails use the site’s brand colour (kept readable) instead of WordPress blue when Promptless WP is active.
- Changed: after a successful submit the form is replaced by its success message, and keyboard focus moves to it. Forms meant to be filled again can keep showing the form with the new “after_submit”: “reset” setting.
1.12.2
- Fixed: when “Next” finds problems on a step, focus now goes to the first one, not the last.
- Fixed: after Next or Previous, focus moves to the new step (its title, or “Step 2 of 3”), and the progress indicator marks the current step for screen readers.
- Fixed: a single-step form and the last step of a multi-step form now show the same announced inline errors as “Next”, instead of the browser’s pop-up bubble. Every submission is still checked on the server.
- Fixed: email and phone fields tell the browser what they hold, so it can offer to fill them in. A value you set yourself still wins.
1.12.1
- Fixed: a required dropdown now opens on an empty “Choose an option” (or its placeholder), so a visitor can no longer submit a value they never picked. Optional dropdowns are unchanged.
- Fixed: the AI connector now reports a refused or failed request as an error (including rate limits, with a retry time) instead of as a success.
1.12.0
- Fixed: on the Form Entries list, the Email column showed a dash that looked like a delivery failure when a form’s own notification is turned off — the normal setup when a FlowMint workflow sends your team’s email instead. It now says “Off”, and where a workflow sends the email the column shows what the workflow did, with a link to it.