Forms
A form is a signup box you put on a site you already have, or share as a hosted page. Every submission becomes a contact. If you want a whole page instead of a box, build a landing page.
Create a form
Go to Pages & Forms > Forms and click New form. The editor opens on a form called "Untitled form" that asks for email and first name. Rename it in the top bar, change the settings on the left, and click Save. Nothing is saved until you click it.
| Section | What it controls |
|---|---|
| Subscribe to | The list new signups join, or "No list (collect only)". |
| Fields shown | Email is always on. First name and Last name are optional. |
| Button | Button text, background colour, text colour, corner radius (0 to 24 px). |
| Success message | The text a visitor sees after submitting. Default: "Thanks! You're subscribed." |
| How it appears | Display mode, and for overlays when they show up. |
A form cannot ask for custom contact fields. It collects email, first name and last name only.
Display modes and triggers
Under How it appears you pick one of four display modes:
- Inline: drawn in the page where you paste the snippet.
- Popup: centred over the page with a dimmed backdrop. It keeps keyboard focus inside while open.
- Slide-in: a card in the bottom right corner. It does not block the page.
- Banner: a full-width bar pinned to the bottom.
For the three overlay modes, When it appears adds a trigger:
| Trigger | Setting |
|---|---|
| As soon as the page loads | None. |
| After a delay | Seconds on the page, 0 to 600. |
| After scrolling | Percent of the page scrolled, 0 to 100. |
| On exit intent | The pointer leaves toward the browser bar. Touch devices fall back to a 20 second delay. |
Overlays also have days hidden after someone dismisses it (0 to 365, default 30). The choice is remembered in the visitor's browser, and a successful signup counts too. At 0 the form comes back on every visit. A visitor can close an overlay with the close button or Escape.
Put it on your site
Under the preview, the editor shows three ways to publish the form:
- Hosted page: a stand-alone page at
https://flomailr.com/forms/FORM_ID. It shows your workspace name above the form. Share the link, no embedding needed. It is always inline. - HTML embed: a plain
<form>that posts to the form's submit address. It works on any page and is always inline. - JS widget: a script that draws the form and submits without reloading. Use it for popup, slide-in and banner. For an inline form, paste the whole snippet where the form should appear.
The snippets carry a copy of your fields, colours and display settings from the moment you copy them. After you change those, copy and paste the snippet again. The list is read on Flomailr's side, so changing Subscribe to applies right away. If you delete a form, sites still embedding it show an error.
To post from your own code instead, see the Forms API.
What happens on submit
- The address is trimmed and lowercased, and must look like an email.
- Each IP address can submit five times in ten minutes. After that the submission is refused.
- The contact gets the tag
form:FORM_ID. The Signups column on the Forms table counts contacts with that tag. - The submission counts as "Submits a form" for lead scoring rules.
Which list a signup joins and whether it needs confirming follow the same rules as every public signup:
| Situation | Result |
|---|---|
| New address, form has a list | Saved as Pending. A "Confirm your subscription to LIST" email goes out under your workspace name. Clicking the link subscribes them, adds them to the list and records consent. |
| New address, "No list (collect only)" | Subscribed straight away. No confirmation email, because the link is tied to a list. |
| Already subscribed | Stays subscribed and is added to the list. |
| Opted out before | With a list, status is unchanged and a confirmation email goes out. Clicking its link resubscribes them. With no list, nothing changes. |
| Hard bounce on record | Refused with "This email address cannot be re-subscribed." |
| Suppressed (bounce, complaint or manual) | Nothing is written. The visitor still sees the success message, so the form cannot reveal who is suppressed. |
An address that is still Pending does not get a second confirmation email within 24 hours, and no address gets more than two in 24 hours. There is no per-form double opt-in switch. See Double Opt-In.
The success message appears in every case above except the refusal, even when the person still has to confirm. Write it to fit, for example "Check your inbox to confirm."
Spam protection
Forms have no CAPTCHA or honeypot field. Protection comes from the per-IP limit, the confirmation throttle and double opt-in. A form never overrides a bounce, a complaint or a manual suppression. See Compliance and Contacts.