RESOURCES

Documentation

How to build your first form, install it anywhere, and turn on AI follow-up or AI chat when you’re ready.

Create your first form

Sign up for a free account, no card required. From the dashboard, open Intake and create a new form. Give it a name (this is just for your own reference, visitors never see it), then head to the Quick Form tab to add fields.

Every form starts on the Free plan: up to 3 forms and 100 submissions a month. That’s enough to fully test Formantly on a real form before deciding whether to upgrade.

Field types

Build your form from these field types, each with its own validation on submission:

  • Text, Textarea, for names, addresses, or a “tell us more” message.
  • Email, Phone, validated to look like a real email address or phone number before they’re accepted.
  • Select, Radio, Multiselect, for a fixed list of choices you define (like a service type dropdown).
  • Checkbox, Consent, for a single yes/no, commonly used for “I agree to be contacted.”
  • File (Pro), lets a visitor attach up to 10 photos per field. On Pro with AI follow-up turned on, the AI actually looks at the photos as part of its analysis, not just storing them.

Mark any field required or optional, and reorder fields by dragging them (or with the arrow buttons) in the Quick Form editor. A form can have up to 40 fields. Keep an Email or Phone field on every form: without one, a lead arrives with no way to reach the person, and the editor warns you if you remove the last one. If you remove a field later, answers already collected for it stay on your existing leads.

Embed script

The simplest way to add a form to your own site. Every form’s Install tab shows this snippet with your real form ID already filled in, ready to paste:

<script
  src="https://api.formantly.com/widget.js"
  data-form-id="your-form-id">
</script>

Drop it anywhere in your page’s HTML, ideally right where you want the form to appear. It loads asynchronously and renders itself in place, matching your form’s configured accent color, button text, and light/dark theme. Most website builders have an HTML, code or embed block for this; the step-by-step section below covers WordPress, Wix, Squarespace, Webflow and Shopify.

If a form has AI Chat turned on instead of Quick Form, this exact same snippet automatically renders a chat bubble in the corner of the page instead, no separate install step.

Your own HTML form

Already have a form built into your site and just want Formantly to receive and process its submissions? Point your form’s own action attribute at our submission endpoint instead of using the embed script:

<form action="https://api.formantly.com/v1/forms/your-form-id/submissions" method="POST">
  <input name="name" required>
  <input name="email" type="email" required>
  <button type="submit">Send</button>
</form>

Field names in your HTML must match your form’s field keys exactly. If a required field has the wrong name, the form is refused; if an optional field has the wrong name, the lead still arrives but that answer is quietly left out. The Install tab shows a complete form for your real fields, with a table of every input name, so you can copy it instead of guessing. Drop-downs and radio buttons must send the exact text of a choice, a ticked checkbox sends on, and photo uploads work only with the embed script.

This method keeps your own markup, styling, and any existing JavaScript exactly as-is; Formantly only handles what happens after submit (spam checks, storage, notification, and AI, if enabled). After a plain HTML form is sent, the visitor lands on a simple confirmation page. To send them back to your own thank-you page instead, set a Redirect URL on the Experience tab. Form plugins and builders often don’t let you change the action address or the input names; if yours doesn’t, use the embed script instead.

Both formats are also available on the Test tab, where you can send a real submission through and confirm it lands correctly in your dashboard before going live.

Standalone form page

Don’t have a website yet, or want a link you can drop directly into a Google/Facebook ad, WhatsApp, or your Instagram bio? Every form, on every plan, already has its own hosted page at a formantly.com link, shown on the Install tab. No embedding required.

On Pro, you can point a real domain you own (like enquiry.yourbusiness.com) at that same page instead, so it looks fully like your own site. Add the domain from the Install tab and follow the DNS instructions shown there; verification usually completes within a few minutes of the DNS record propagating.

Step by step, by website builder

The Install tab gives you one snippet. Where you paste it depends on your website builder. The steps below were checked against each builder’s own help pages on 2026-09-20. Builders rename menus from time to time, so if a name differs slightly, look for an HTML, code or embed block. If you get stuck at any step, contact us with your website builder and the page address, and we will help you set it up.

WordPress

  1. Open the page or post in the editor.
  2. Click the + (block inserter) and search for Custom HTML, or type /html on a new line.
  3. Click Edit HTML and paste the snippet.
  4. Click Update, then publish or update the page.

On WordPress.com, the help page lists script among the tags that need a paid plan with hosting features activated (activated by installing at least one plugin). Without that, the snippet will not run, so use your standalone form link instead.

Source: WordPress.com Help, Custom HTML block

Wix

  1. In the Wix Editor, click Add Elements on the left.
  2. Choose Embed Code, then Popular Embeds, then Embed HTML, and click it to add it to the page.
  3. Click Enter Code, paste the snippet and click Apply.
  4. Resize the box so the whole form fits, then publish the site.

Wix says its HTML element is an iFrame, so the embedded code won’t be responsive; set the box size yourself and check the page on a phone. Our advice, not Wix’s: because the form runs inside that frame, leave Allowed domains empty on the Experience tab, and use the form rather than AI Chat there, since a chat bubble can only float inside the frame.

Source: Wix Help, Embedding a site or a widget

Squarespace

  1. Edit the page, hover over the section and click Add Block (the + button).
  2. Choose Code, then click the pencil icon on the block.
  3. Set the block type to HTML, leave Display Source off, and paste the snippet.
  4. Save the page.

Squarespace says JavaScript in Code blocks is available on the Core, Plus, Advanced, Business, Commerce Basic and Commerce Advanced plans. On another plan, use your standalone form link.

Source: Squarespace Help, Code blocks

Webflow

  1. In the Designer, open the page and add a Code Embed element where the form should appear.
  2. Paste the snippet into the code box and save.
  3. Publish the site. The embedded code only runs on the published site, not in the Designer preview.

Webflow says the Code Embed element needs a Core, Growth, Agency or Freelancer Workspace, or a site with an active Site plan. Don’t add html, body or head tags around the snippet.

Source: Webflow Help, Custom code embed

Shopify

  1. In your Shopify admin go to Online Store and open Themes.
  2. Next to your theme, click Customize (Shopify’s help calls it Edit theme).
  3. Open the page where the form should go and click Add section.
  4. Choose Custom Liquid and paste the snippet into it, then click Save.

Shopify notes that a Custom Liquid section is available only if your theme offers one. If yours doesn’t, ask your theme developer or use your standalone form link.

Source: Shopify Help, Extend your theme with apps (Custom Liquid section)

Source: Shopify Help, Sections and blocks (adding a section)

Any other website

Paste the snippet into the page’s HTML, inside the body, where the form should appear. If your builder or email tool doesn’t allow scripts, share your standalone form link instead.

Showing it on every page

A Quick Form usually belongs on one page (a contact page, a landing page), so the steps above paste the snippet right where it should appear. AI Chat is different: it’s a floating bubble, meant to follow a visitor around your whole site, not sit on one page. For that, paste the exact same snippet into whatever your builder calls its site-wide or global code area instead of a single page’s content, so it loads on every page from one place:

  • WordPress: Appearance → Theme File Editor → footer.php, just before </body>. If your theme doesn’t allow editing files, most page-builder plugins (Elementor, Divi, and others) have their own “Custom Code” or “Footer Scripts” setting under Theme Settings, which applies to every page without touching a file.
  • Wix: Settings → Custom Code → Add Custom Code, set it to load on All Pages and in the Body - end position.
  • Squarespace: Settings → Advanced → Code Injection, paste it into the Footer box (this applies site-wide; it’s different from the page-level Code block used for a Quick Form).
  • Webflow: Site Settings → Custom Code → Footer Code, then publish the site.
  • Shopify: Online Store → Themes → Edit code, open theme.liquid, and paste it just before </body> so it loads on every page of the storefront.
  • Any site using Google Tag Manager: create a Custom HTML tag with the snippet, set its trigger to All Pages, and publish the container. This works regardless of what built the site underneath.

However you add it, the chat remembers a visitor across pages on its own (as long as it’s the same browser), so moving from page to page never restarts their conversation.

If you already had the snippet pasted on one specific page (for example a Quick Form on your contact page), remove that copy once you add the site-wide one, so that page doesn’t load it twice. Loading it twice for the same form is harmless either way, it only ever renders once, but there is no reason to keep the extra copy around.

Using an AI coding agent

If you edit your site with an AI coding agent (Claude Code, Cursor, or similar) instead of by hand, paste this as your instruction to it, with your real snippet from the Install tab in place of the placeholder below:

Add this script tag so it loads on every page of this site (a site-wide/global
layout file, footer partial, or base template, not one single page):

<script
  src="https://api.formantly.com/widget.js"
  data-form-id="your-form-id">
</script>

Place it right before the closing </body> tag. Don't wrap it in any other
tags, and don't add async/defer attributes, it already loads asynchronously
on its own.

An agent with access to your codebase will find the right shared layout file itself (a Next.js layout.tsx, a Rails application.html.erb, a Django base template, and so on) rather than needing you to name it.

If something doesn’t work

  • The form doesn’t appear. Check that the whole snippet was pasted, that the intake is Active (not Draft, Paused or Archived), and that your plan allows scripts (see the notes for your builder above). If you use a caching plugin or a CDN, clear the cache and reload.
  • “This form cannot be submitted from this domain.” Your Allowed domains list on the Experience tab doesn’t include the website the form is on. Add it, or clear the list.
  • Your own HTML form shows only “Required”. A required input is empty or is named differently from the Install tab’s table. Compare each name with the table. Also check optional fields: with a wrong name they don’t cause an error, their answer is just missing from the lead.
  • Visitors leave your site after sending your own HTML form. The form from the Install tab stays on your page and shows a confirmation card. If you wrote your own form that posts straight to the address, the browser opens a confirmation page instead: set a Redirect URL on the Experience tab to send visitors back to your own thank-you page.
  • The chat bubble doesn’t show. AI Chat needs Pro, and the intake’s Experience tab must be set to AI Chat.
  • “Too many requests”. A visitor or a test sent several enquiries in a short time. Wait a minute and try again.

Still not working? Use the Test tab to send a real enquiry through the intake, or contact us for help with the page address and your website builder, and we will look at it with you.

AI follow-up

Available on Pro. Once turned on, here’s exactly what happens to every new lead:

  1. The submission is analyzed immediately: intent, urgency, and anything important that’s missing.
  2. About 15 minutes later (adjustable), a personalized follow-up email goes out, referencing what the lead actually asked for.
  3. If they reply, the AI reads it and either asks one more useful question, answers from your approved FAQs, or recognizes the lead is ready and marks it Qualified.
  4. Whenever a customer asks for a person, is ready to book, asks for a binding price, or the situation needs human judgment, it hands off to you immediately with a summary instead of continuing.

As a hard backstop, a conversation always hands off automatically after 8 AI replies or 7 days, whichever comes first, so nothing is left running on autopilot indefinitely.

AI chat

Also on Pro, and using the same AI Assistant configuration as follow-up. Switch a form’s Experience tab from Quick Form to AI Chat, and visitors get a floating chat bubble instead of a static form.

What a visitor sees

A small nudge appears next to the chat bubble a few seconds after a first-time visitor lands (or after they scroll a quarter of the way down the page, whichever comes first), worded plainly as “Chat with us,” never implying a person is waiting, since this is the AI. It shows once per browser tab and can be dismissed. Opening the chat starts a brief, almost always invisible verification, then a real, streamed conversation: your AI assistant asks what they need, replies as they type, and gathers their name, contact details, and the specifics of the job, the same information a form field would ask for, just through conversation. The chat header always identifies it as an AI assistant, it never poses as a person on your team.

The conversation follows the visitor around your site

Once a visitor has said anything, the same conversation picks back up if they move to another page, reload, or open a new tab of the same browser, for up to 24 hours of inactivity. When the chat ends (the visitor uses End chat, or the AI wraps things up), the panel shows a short rating prompt and then a Start new chat option, rather than either a dead input box or silently forgetting the finished conversation.

Handing off to a real person

Whenever the AI hands off (the visitor asks for a person, or the situation calls for it), you get an email with a no-login link to join that exact live chat and reply in real time, alongside the usual lead notification. The visitor sees the chat is waiting on the team, then sees your replies arrive as you type them.

If something goes wrong

If the chat can’t get a response (a network hiccup, a temporary outage), it falls back to your regular Quick Form fields right inside the same chat panel, so a visitor is never left looking at a dead chat box with no way to reach you.

Configuring your AI

Both AI follow-up and AI chat read from the same settings, on your dashboard’s AI Assistant page:

  • Services offered / not offered, so the AI knows what to say yes and no to. Paste text straight from your own website and let AI turn it into a clean list, instead of typing it by hand.
  • Special instructions, anything you always want it to do, ask, or never promise.
  • FAQs, questions it can answer directly and confidently, in your own words.
  • Qualified-lead email, an optional separate address just for leads the AI marks Qualified or hands off.

Use Analyze my website on the same page to have AI read your actual site and draft your trade, services, and tone for you to review, so you don’t have to start from a blank form. Use Preview conversation to see exactly what a lead would receive before turning anything on for real visitors.

Notifications & team

Every new lead sends an instant email notification to your verified recipient, and the visitor gets an automatic thank-you. Add and verify more recipients from your dashboard’s Settings so more than one person on your team hears about a new lead. Free supports 1 recipient, Pro supports up to 5.

Every plan also gets an in-dashboard notification bell (sidebar and mobile top bar) for a new lead, an AI-qualified lead, or a handoff, with a full history under Notifications.

Webhooks

On Pro, add a webhook under Settings > Webhooks to get a signed HTTP POST whenever a lead comes in, gets AI-qualified, needs a handoff, or a conversation closes, useful for connecting Zapier, Make, or your own endpoint.

{
  "event": "submission.created",
  "data": { "leadId": "...", "formName": "...", "name": "...", "email": "...", "phone": "..." },
  "timestamp": "2026-09-17T12:00:00.000Z"
}

Every request includes an X-Formantly-Signature: sha256=... header, an HMAC-SHA256 of the raw request body using your webhook’s own secret (shown once, at creation), the same scheme GitHub uses for its own webhooks. Verify it on your end before trusting the payload. A failing endpoint gets retried up to 5 times over about 8 hours before we give up on that delivery.

Custom sending domain

On Pro, verify your own domain under Settings > Email & Domains, and every notification and follow-up email sends from your business’s own address instead of showing Formantly branding. Free workspaces still get full email delivery, just sent “via Formantly.”

Analytics

Every plan gets lead volume over time, a status breakdown, and how much spam was blocked. Pro adds average first-response time, AI qualification rate, and a breakdown of lead urgency as detected by AI, so you can see whether AI follow-up is actually converting better than a static form alone.

Spam & security

Every form and chat widget is protected by a hidden honeypot field, rate limiting at multiple layers and a content score, all running automatically with nothing for you to configure. Forms shown on your Formantly form page or a verified custom domain also get Cloudflare Turnstile bot verification. Turnstile cannot run on a form embedded in your own website, so there the honeypot, rate limits and spam scoring do the work, and AI chat has a daily cap on new conversations per form. Visitor IP addresses are stored only as a one-way hash, never in plain text. Full detail on our Security page.

Plans at a glance

 FreePro
Forms310
Submissions / month1005,000
Standalone form pageFormantly linkYour own domain
AI follow-up & AI chat-Included
Photo uploads-Included
Notification recipients15
Webhooks-Included
Sending domainvia FormantlyYour own domain
Leads keptUntil you delete themUntil you delete them
Uploaded photos kept-12 months

Full pricing on the homepage.

Still stuck?

Use the contact form, email hello@formantly.com, or check the FAQ. We read every message ourselves.

Formantly Documentation: Forms, AI Follow-Up and Chat