narrativecode

<p>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.</p>
<h4>Why an HTML form plugin beats a drag and drop builder</h4>
<p>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>
<h4>Build forms with AI: paste from ChatGPT, Claude, or Gemini</h4>
<p>Because forms are just HTML, any large language model can build one for you. Ask ChatGPT, Claude, Gemini, or your favourite AI for a contact form with a name, email, a dropdown, and a file upload, copy the HTML it returns, and paste it into Narrative Forms. There is no proprietary field format to satisfy, so whatever the AI generates simply works as an HTML form. That makes Narrative Forms an AI friendly form plugin: you bring your own model, paste the markup, and ship the form. The free plugin is completely model agnostic, so you are never tied to one AI. Prefer it built in? AI form generation that writes the HTML for you inside WordPress is on the Narrative Forms Pro roadmap. For now, the free HTML form plugin already works with any AI you paste in.</p>
<h4>Everything in the free HTML forms plugin</h4>
<p>The free HTML forms plugin is a complete forms solution, not a teaser. Here is what every install includes:</p>
<ul>
<li><strong>Fast AJAX form submissions.</strong> Forms submit without a page reload, and there is a graceful fallback when JavaScript is turned off, so the form never breaks for a visitor. AJAX form submissions also keep your pages cache friendly, because the page can stay static while the form posts in the background.</li>
<li><strong>A built in HTML editor.</strong> One click field buttons generate the markup for common fields, and a live preview shows the form as you type. Write the HTML by hand, scaffold it quickly with the buttons, or paste a form an AI wrote for you. The editor never hides your markup behind a visual builder, so what you see is what ships.</li>
<li><strong>Email notifications.</strong> Send a clean, readable email for every form submission, to yourself or any address, in plain text or HTML. Each field is formatted tidily, and you can route different forms to different inboxes with separate email actions.</li>
<li><strong>Webhook actions.</strong> Send form data to any URL when the form is submitted. Connect your forms to Zapier, Make, a CRM, or your own endpoint with a webhook, no code required, and add more than one webhook action per form so one submission can fan out to several services.</li>
<li><strong>File upload form fields.</strong> Accept a file upload field with a maximum file size and a maximum number of files per field. Uploaded files are stored safely in the WordPress media folder and recorded with the submission, so building a file upload form is one paste of HTML away.</li>
<li><strong>Stored form submissions and CSV export.</strong> Optionally keep every submission in a fast, indexed database table that you browse in the admin. Run a CSV export of your form submissions at any time; the export streams in batches, so it works even with very large numbers of submissions and never times out.</li>
<li><strong>Layered spam protection.</strong> Stop bots with a honeypot, a time trap that rejects instant submissions, a same origin referrer check, a limit on the number of links in a message, and an optional rate limit per IP. You can also switch on Cloudflare Turnstile for a privacy respecting CAPTCHA. This spam protection adds no third party tracking to your site.</li>
<li><strong>Custom messages and redirects.</strong> Set your own success and error messages, redirect to any URL after a successful submit, and use template tags so the form behaves exactly how you want.</li>
<li><strong>Clean, optional styling.</strong> A calm, minimal stylesheet ships with the plugin and is on by default, and you can switch it off in one click if your theme or custom CSS should own the look. Semantic wrapper classes keep your theme in charge of how your HTML form appears.</li>
</ul>
<p>Every output is escaped and every input is sanitised, following WordPress coding and security standards, so the plugin stays review safe and secure.</p>
<h4>Contact forms, custom forms, and every form in between</h4>
<p>Narrative Forms is a general purpose form plugin, so the same HTML first workflow covers almost any form you need to build. Use it for a simple contact form, a lead capture form, a support request form, a job application, an RSVP, a survey, a registration form, a file upload form, or a custom form with a layout that a drag and drop builder cannot easily produce. Because a field is just an HTML element with a name attribute, you can mix text inputs, email fields, dropdowns, checkboxes, radio buttons, date pickers, textareas, and file upload fields in any structure you like.</p>
<p>Agencies and developers reach for this HTML form plugin when a client needs a form that does not fit a builder’s template: a multi column layout, a branded card, a stepper, a pricing calculator, or markup a designer handed over. You paste the HTML, give the fields names, and the form is live with AJAX form submissions, stored data, 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.</p>
<p>It is also a great fit when you want to keep your stack lean. A single lightweight form plugin handles your contact form, your file upload form, and your custom forms, with email and webhook actions for routing, layered spam protection to keep out bots, and stored form submissions you can export to CSV whenever you need them. Whether you collect a handful of submissions a month or millions over time, the same plugin scales with you.</p>
<h4>Developer friendly HTML form plugin</h4>
<p>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 (<code>nrfm-submit</code>, <code>nrfm-submitted</code>, <code>nrfm-success</code>, <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, so you can extend this HTML form plugin without forking it.</p>
<h4>Built to scale to millions of form submissions</h4>
<p>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>
<h4>Who this HTML forms plugin is for</h4>
<ul>
<li>Developers and agencies who want a contact form or custom HTML form they fully control, without a heavy builder.</li>
<li>Anyone who uses an AI assistant: generate the HTML, paste it, and you are done.</li>
<li>Site owners who need reliable form submissions, email notifications, file upload forms, and CSV export without the bloat.</li>
<li>Teams that have outgrown a drag and drop form builder and want a faster, lighter way to build forms.</li>
</ul>
<p>Common uses include contact forms, lead capture, support requests, job applications, RSVPs, surveys, file uploads, registrations, and multi field custom forms that a drag and drop builder cannot easily produce.</p>
<h4>Upgrade to Narrative Forms Pro</h4>
<p>Narrative Forms Pro keeps the same lightweight, HTML first core and adds the power features that busy sites and agencies need:</p>
<ul>
<li>Conditional logic: show or hide fields, and trigger actions, based on what the visitor enters.</li>
<li>Save and resume: let visitors save a long form as a draft and finish it later from where they left off.</li>
<li>Submission notifications: a badge for unread form submissions in the admin so a new entry never slips by.</li>
<li>Require login: restrict any form to logged in users only.</li>
<li>Schedule windows: open and close a form automatically on the date and time you set.</li>
<li>Advanced webhooks: reusable webhook templates, automatic retries with backoff, and a delivery log for every call.</li>
<li>REST API: read form submissions programmatically and connect your forms to anything.</li>
<li>Share links: generate a hosted, shareable link to any form.</li>
</ul>
<p>AI form generation, which writes the HTML for you from a plain language description, is on the Pro roadmap. Today the free HTML form plugin already works with any AI you paste in. Learn more at https://narrative-forms.com/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=free</p>
<h4>Publish form submissions with Frontend Submissions (Views)</h4>
<p>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 a paid add on that 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>
<h3>Privacy</h3>
<p>Narrative Forms uses the <a href="https://appsero.com" rel="nofollow ugc">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>
<p>The Appsero SDK <strong>does not gather any data by default.</strong> It only starts collecting basic telemetry <strong>when you allow it through the admin notice</strong>. We collect the data to ensure a great experience for all of our users.</p>
<p>Integrating the Appsero SDK <strong>DOES NOT IMMEDIATELY</strong> start gathering data, and never <strong>without your confirmation.</strong></p>
<p>Learn more about how <a href="https://appsero.com/privacy-policy/" rel="nofollow ugc">Appsero collects and uses this data</a>.</p>
<h3>External services</h3>
<p>This plugin connects to external services only in these optional cases, and each is off until you enable or allow it.</p>
<ul>
<li><strong>Cloudflare Turnstile (optional CAPTCHA).</strong> Used only if you enable Turnstile. When a page with a form loads, the browser requests <code>https://challenges.cloudflare.com/turnstile/v0/api.js</code> to render the widget; on submit, the server sends the Turnstile token, your secret key, and the visitor’s IP address to <code>https://challenges.cloudflare.com/turnstile/v0/siteverify</code> to verify it. Terms: <code>https://www.cloudflare.com/website-terms/</code> Privacy: <code>https://www.cloudflare.com/privacypolicy/</code></li>
<li><strong>Webhooks (optional, configured by you).</strong> Used only if you add a Webhook action. After a successful submission, the submitted form fields plus limited metadata (timestamp, IP address, user agent, referrer) are sent as JSON or URL encoded data to the exact URL you configure, on a domain you choose. Example URLs in the UI are placeholders and receive nothing. The destination is your choice, so consult that service’s terms and privacy policy.</li>
<li><strong>Appsero (optional usage analytics).</strong> Off until you allow it through the admin notice; nothing is sent before that. It then sends basic environment details (site URL, WordPress and PHP versions, active theme and plugins, locale, and the admin email used to confirm) to <code>https://api.appsero.com</code>, plus an optional survey if you deactivate. No form submissions or visitor data are sent. Privacy: <code>https://appsero.com/privacy-policy/</code></li>
</ul>


HTML Forms & Contact Form for WordPress: Narrative Forms

The HTML form plugin for WordPress: build a contact form or custom form by pasting any HTML, even from AI. Fast AJAX, no drag and drop.

Sunil Kumar Sharma

<p>It is very useful if you want that your website users can submit posts from the site without going to the WordPress back-end.<br />
For Front-end Access Of post form, we have a shortcode <code>[GUEST_POST_FORM role="author"]</code><br />
In this shortcode, you need to pass a user role who can submit a post from the front-end.<br />
Another shortcode is <code>[GUEST_POST_LIST type="guest_post" number=10 status="publish"]</code>.<br />
This shortcode is used for list post with pagination.</p>


Guest Posts

This plugin is generally for front-end post submission and providing admin notification.

HTML Forms & Contact Form for WordPress: Narrative Forms vs Guest Posts