Fixes direct share links needing a manual permalink refresh after a base change, and a direct link field that could stay hidden on the Settings tab until reload. No changes for existing forms.<\/p>","1.2.0":"
Adds webhook delivery logs and retries, webhook templates, a REST API, require login, schedule windows, and share links, all free. Existing forms keep working.<\/p>","1.1.0":"
Adds a built in AI form builder, conditional logic, save and resume, and submission notifications, all free. Existing forms keep working.<\/p>","1.0.4":"
Adds a developer hook (nrfm_field_buttons_after) so add-ons can extend the form editor toolbar. No changes for existing forms.<\/p>","1.0.3":"
Fixes a Security check failed notice on the form edit screen, adds a confirmation when deleting submissions, and stops the form preview from being clipped.<\/p>","1.0.2":"
Adds a ready to use Contact Form on install, enables the basic stylesheet by default, simplifies the field setup panel, and shows form errors inline.<\/p>","1.0.1":"
Adds optional usage analytics (nothing is collected unless you allow it) and updates the readme.<\/p>","1.0.0":"
First public release of Narrative Forms, the HTML form plugin built on plain HTML.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3564563,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3564563,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3564563,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3564563,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3564563,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","1.0.2","1.0.3","1.0.4","1.2.0","1.2.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3565053,"resolution":"1","location":"assets","locale":"","width":2544,"height":882},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3565053,"resolution":"2","location":"assets","locale":"","width":792,"height":904},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3565053,"resolution":"3","location":"assets","locale":"","width":868,"height":956},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3565053,"resolution":"4","location":"assets","locale":"","width":2236,"height":1404},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3565053,"resolution":"5","location":"assets","locale":"","width":1980,"height":958},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3565053,"resolution":"6","location":"assets","locale":"","width":2128,"height":1516},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3565053,"resolution":"7","location":"assets","locale":"","width":1872,"height":792},"screenshot-8.png":{"filename":"screenshot-8.png","revision":3565053,"resolution":"8","location":"assets","locale":"","width":2108,"height":1232},"screenshot-9.png":{"filename":"screenshot-9.png","revision":3565053,"resolution":"9","location":"assets","locale":"","width":2248,"height":1300}},"screenshots":{"1":"Build an HTML contact form by pasting markup, even an AI's: here a custom RSVP card with pill buttons and a star rating.","2":"No field type limits in this HTML form plugin: a table booking form with a seating switcher, a guest stepper, and native date and time pickers.","3":"Build a custom form fast: an instant quote form with selectable option cards and range sliders that update a live price.","4":"The built in HTML editor with one click field buttons, a live preview, and a file upload form field with size and count limits.","5":"The built in AI form builder writing a WordPress form from a plain language prompt, with your own OpenAI compatible API key.","6":"Conditional logic rules that show or hide a field based on what the visitor enters.","7":"Webhook actions with a delivery log and automatic retries, plus Discord, Slack, and Teams payload templates.","8":"Stored form submissions in the admin with one click, batched CSV export.","9":"Appearance and protection settings: an optional stylesheet, honeypot, and Cloudflare Turnstile, privacy friendly with no third party tracking."}},"plugin_section":[],"plugin_tags":[130308,358,5981,2253,98275],"plugin_category":[42],"plugin_contributors":[266173],"plugin_business_model":[],"class_list":["post-275541","plugin","type-plugin","status-publish","hentry","plugin_tags-conditional-logic","plugin_tags-contact-form","plugin_tags-custom-form","plugin_tags-form-builder","plugin_tags-html-forms","plugin_category-contact-forms","plugin_contributors-narrativecode","plugin_committers-narrativecode"],"banners":{"banner":"https:\/\/ps.w.org\/narrative-forms\/assets\/banner-772x250.png?rev=3564563","banner_2x":"https:\/\/ps.w.org\/narrative-forms\/assets\/banner-1544x500.png?rev=3564563","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/narrative-forms\/assets\/icon.svg?rev=3564563","icon":"https:\/\/ps.w.org\/narrative-forms\/assets\/icon.svg?rev=3564563","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/narrative-forms\/assets\/screenshot-1.png?rev=3565053","caption":"Build an HTML contact form by pasting markup, even an AI's: here a custom RSVP card with pill buttons and a star rating."},{"src":"https:\/\/ps.w.org\/narrative-forms\/assets\/screenshot-2.png?rev=3565053","caption":"No field type limits in this HTML form plugin: a table booking form with a seating switcher, a guest stepper, and native date and time pickers."},{"src":"https:\/\/ps.w.org\/narrative-forms\/assets\/screenshot-3.png?rev=3565053","caption":"Build a custom form fast: an instant quote form with selectable option cards and range sliders that update a live price."},{"src":"https:\/\/ps.w.org\/narrative-forms\/assets\/screenshot-4.png?rev=3565053","caption":"The built in HTML editor with one click field buttons, a live preview, and a file upload form field with size and count limits."},{"src":"https:\/\/ps.w.org\/narrative-forms\/assets\/screenshot-5.png?rev=3565053","caption":"The built in AI form builder writing a WordPress form from a plain language prompt, with your own OpenAI compatible API key."},{"src":"https:\/\/ps.w.org\/narrative-forms\/assets\/screenshot-6.png?rev=3565053","caption":"Conditional logic rules that show or hide a field based on what the visitor enters."},{"src":"https:\/\/ps.w.org\/narrative-forms\/assets\/screenshot-7.png?rev=3565053","caption":"Webhook actions with a delivery log and automatic retries, plus Discord, Slack, and Teams payload templates."},{"src":"https:\/\/ps.w.org\/narrative-forms\/assets\/screenshot-8.png?rev=3565053","caption":"Stored form submissions in the admin with one click, batched CSV export."},{"src":"https:\/\/ps.w.org\/narrative-forms\/assets\/screenshot-9.png?rev=3565053","caption":"Appearance and protection settings: an optional stylesheet, honeypot, and Cloudflare Turnstile, privacy friendly with no third party tracking."}],"raw_content":"\n
Narrative Forms is the HTML form plugin for WordPress. Instead of dragging boxes around a builder, you write plain semantic HTML, or paste it straight from an AI like ChatGPT, Claude, or Gemini, and Narrative Forms turns it into a real form with fast AJAX form submissions and stored, exportable data. Any input with a name attribute is saved. That is the whole idea: forms are just HTML, so there is no field type registry, nothing proprietary to lock you in, and no ceiling on what your form can be. If you want a clean, fast, developer friendly HTML form plugin, a simple contact form, or a custom form that a heavy form builder cannot easily produce, this is it. It stays lightweight, loads its assets only on pages that contain a form, and is built to scale to millions of submissions. Everything it does is free, with no premium tier: the AI form builder, conditional logic, webhooks with delivery logs and retries, a REST API, require login, schedule windows, and hosted share links are all included at no cost.<\/p>\n\n
Most WordPress form plugins lock you into a drag and drop form builder and a fixed list of field types. If the builder does not offer a field, you cannot have it. Narrative Forms is an HTML form plugin with no field registry: a field is simply an HTML element with a name. Need a multi step layout, an unusual input, a custom widget, or markup your designer already wrote? Paste it in and it works. You keep full control of the markup, the classes, and the look, so your contact form or custom form renders exactly the way you built it. Drag and drop made sense years ago. Today you describe what you want or paste what you already have. No builder, no bloat, and no fighting a clunky UI to recreate a form you can already picture. That is why people who outgrow a drag and drop form builder move to a real HTML form plugin.<\/p>\n\n
Because forms are just HTML, any large language model can build one for you, and Narrative Forms gives you two ways to use that. The built in AI form builder writes the form HTML for you right inside WordPress: open a form, click Generate with AI, describe what you want, and keep refining it by chatting. You bring your own API key for an OpenAI compatible provider such as DeepSeek, OpenAI, or OpenRouter, so you stay in control of the model and the cost. You can also paste from anywhere: ask ChatGPT, Claude, or Gemini for a form and drop the HTML in, because there is no proprietary field format to satisfy. Either way, the plugin stays model agnostic, ships with no AI key, and contacts no AI service until you add one; see the Privacy and External services sections for what is sent and when.<\/p>\n\n
The free HTML forms plugin is a complete forms solution, not a teaser. Here is what every install includes:<\/p>\n\n
Every output is escaped and every input is sanitised, following WordPress coding and security standards, so the plugin stays review safe and secure.<\/p>\n\n
Narrative Forms is built to move your form submissions wherever they need to go. Add a webhook action with your endpoint URL and every submission is delivered to that webhook, so you can connect a form to Zapier, Make, a CRM, Discord, Slack, Microsoft Teams, or your own service without writing code. A webhook delivery log shows every call and its response, failed webhooks retry automatically with backoff, and webhook templates let you shape a custom JSON payload with one click presets for Discord, Slack, and Teams. When you would rather pull data than push it, the REST API exposes your form submissions under the nrfm\/v1 namespace, protected by a capability check or an API key. Add conditional logic to show or hide fields, require login to restrict a form, and schedule windows to open and close it automatically, and your form data never gets stuck in the admin.<\/p>\n\n
Narrative Forms is a general purpose form plugin, so the same HTML first workflow covers almost any form: a simple contact form, a lead capture or support request form, a job application, an RSVP, a survey, a registration form, a file upload form, or a custom form with a layout a drag and drop builder cannot easily produce. Because a field is just an HTML element with a name attribute, you paste the HTML, give the fields names, and the form is live with AJAX form submissions, stored data, conditional logic, and CSV export. There is no template to fight and no field type you cannot add, which is the difference between an HTML form plugin and a drag and drop form builder, and the same lightweight form plugin scales from a handful of submissions a month to millions over time.<\/p>\n\n
Narrative Forms is built for people who like control. Prefill fields with template variables such as {{ user.email }}, {{ get.utm_source | default:'direct' }}, or {{ site.name }}, using providers like user, URL parameters, post, site, and date, each with filters such as default, upper, lower, date, and truncate. On the front end, public JavaScript events ( Narrative Forms is engineered for sites that collect a lot of data. Form submissions live in a dedicated, indexed database table rather than bloated post meta, so lookups stay fast as the table grows. Repeated reads are cached, queries are paginated and bounded, CSV export streams in batches, and heavy work can run in the background so the front end stays quick. Whether you collect ten form submissions a month or millions over time, this lightweight form plugin is designed to stay responsive. Scaling to millions describes the architecture, indexed storage, caching, and bounded queries, rather than a benchmarked guarantee.<\/p>\n\n Common uses include contact forms, lead capture, support requests, job applications, RSVPs, surveys, file uploads, registrations, and multi field custom forms with conditional logic that a drag and drop builder cannot easily produce.<\/p>\n\n Most form plugins keep submissions locked in the admin. The Narrative Forms Frontend Submissions add on turns your form submissions into front end content with reusable Views: display any form's submissions as a public directory, a testimonial wall, a photo gallery, a job board, an event timeline, or product reviews, with instant search, pagination, single pages, per field privacy, and approval moderation. Frontend submission display is the one paid add on and it requires the free Narrative Forms plugin. Collect with the form, publish with a View. Learn more at https:\/\/narrative-forms.com\/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=free<\/p>\n\n Narrative Forms uses the Appsero<\/a> SDK to collect some telemetry data, but only after you confirm it. This helps us troubleshoot problems faster and make product improvements.<\/p>\n\nnrfm-submit<\/code>, nrfm-submitted<\/code>, nrfm-success<\/code>, nrfm-error<\/code>) let you push conversions to Google Tag Manager or your dataLayer, show a toast, or run any custom logic with a tiny nrfm.on() helper. Filters and actions sit at every decision point, including the form HTML, validation, and webhook request arguments, and a REST API is available for reading and managing form submissions, so you can extend this HTML form plugin without forking it.<\/p>\n\nBuilt to scale to millions of form submissions<\/h4>\n\n
Who this HTML forms plugin is for<\/h4>\n\n
\n
Publish form submissions with Frontend Submissions (Views)<\/h4>\n\n
Privacy<\/h3>\n\n