Reference
Form settings
Every setting of a form.
Settings of a whole form, in the groups of the builder's Form settings tab. Emails, confirmations, integrations and payments have their own guides.
General
| Setting | Kind | Default | Notes |
|---|---|---|---|
| Title shown above the form | Text | ||
| Show the title | On or off | On | |
| Title heading level | Choice: H1, H2, H3, H4, Not a heading | H2 | |
| Introduction | Formatted text | ||
| Show the introduction | On or off | On | |
| Submit button text | Text | ||
| Name in the forms list | Text | Only staff see it. Empty uses the form title. | |
| Internal note | Text | For your team, for example who owns the form. Shown in the forms list, never to visitors. | |
| Form language | Language | Used for dates, numbers and built in messages. Empty follows the site language. | |
| Text direction | Choice: From the language, Left to right, Right to left | From the language | |
| Mark fields as | Choice: Required (asterisk), Required (the word "required"), Optional (the word "optional" on optional fields) | Required (asterisk) | |
| Default required message | Text | ||
| Message while the form is switched off | Formatted text |
Appearance
| Setting | Kind | Default | Notes |
|---|---|---|---|
| Design | Choice: Clear, Soft, Outline, Underline, Card, Compact, High contrast, Match my theme | Clear | |
| Colours | Choice: Light, Dark, Follow the visitor's system | Light | |
| Accent colour | Colour | #0d6e6e | |
| Text on the accent colour | Colour | #ffffff | |
| Label colour | Colour | Empty uses the text colour of the page. | |
| Required marker colour | Colour | Empty uses the error colour. | |
| Placeholder colour | Colour | Placeholders need a contrast of at least 4.5 to 1 with the field; the Check warns when they do not. | |
| Corner radius (px) | Whole number | ||
| Spacing | Choice: Compact, Comfortable, Spacious | Comfortable | |
| Field size | Choice: Small, Medium, Large | Medium | |
| Labels | Choice: Above the field, Beside the field (wide screens), Inside the field | Above the field | |
| Label width for side labels (px) | Whole number | 180 | |
| Choice style | Choice: Standard, Buttons, Cards | Standard | |
| Button style | Choice: Solid, Outline, Soft | Solid | |
| Button alignment | Choice: Start, Centre, End, Full width | Start | |
| Maximum width | CSS length | ||
| Form position | Choice: Start, Centre | Start | |
| Custom CSS for this form | CSS | Scoped to this form. Use the documented classes such as .flvf-field and the --flvf-f- tokens. | |
| Custom JavaScript for this form | js | Runs after the form, with the variable form set to its outer element. Only administrators who may post unfiltered HTML can change it, and it only runs when Settings, Interface allows custom JavaScript. Prefer the documented events (flvf:ready, flvf:success and others). | |
| Fade in fields that conditions show | On or off | On | A short fade. Visitors whose device asks for less motion see none. |
Steps
| Setting | Kind | Default | Notes |
|---|---|---|---|
| Progress indicator | Choice: Bar with step count, Bar with percentage, List of step titles, None | Bar with step count | |
| Progress text | Text | ||
| Back button | Choice: Before Next, After Next, Hidden | Before Next | |
| Next button text | Text | ||
| Back button text | Text | ||
| Icons on Next and Back | Choice: Arrows, Chevrons, None | Arrows | |
| Space above the form when scrolling to it (px) | Whole number | 40 | Increase this when the site has a fixed header. |
Submission
| Setting | Kind | Default | Notes |
|---|---|---|---|
| Send without reloading the page | Choice: Yes, with a fallback, No, always reload | Yes, with a fallback | Reloading can help when another plugin changes the responses of this site. |
| List problems when sending fails | On or off | On | Each problem links to its field, and focus moves to the list. |
| Problem list heading | Text | ||
| Problem list position | Choice: Top of the form, Bottom of the form, under the buttons | Top of the form | |
| Problem list icon | Icon | circle-alert | |
| Button text while sending | Text | ||
| Cover the form while it is sending | On or off | Off | A light cover with a spinner stops double changes while the answers are sent. The button text also changes. |
| Show a button that clears the form | On or off | Off | Clearing puts every answer back to its starting value. Most forms do not need it; it is easy to press by mistake. |
| Clear button text | Text | ||
| Ask before clearing | On or off | On | |
| Fill in answers from a link to an earlier entry | On or off | Off | Signed links from a confirmation or from an entry fill in fields with the same name. Anyone with the link can see those answers until it expires. |
| Forms it may continue from | forms | Entries of this form are always accepted. | |
| Reference number prefix | Text | Each entry gets a reference such as REQ-001042 for {entry:reference}. | |
| First reference number | Whole number | 1 | |
| Reference digits | Whole number | 0 | Pads with zeros, for example 6 gives 001042. |
Schedule and limits
| Setting | Kind | Default | Notes |
|---|---|---|---|
| Open and close the form automatically | On or off | Off | |
| Opens | Date and time | In the site time zone, +00:00 (Settings, General). | |
| Closes | Date and time | ||
| Message before opening | Formatted text | ||
| Show when the form opens, with a countdown | On or off | On | |
| Message after closing | Formatted text | ||
| Maximum number of entries | Whole number | Counts completed entries; spam, trash and test entries do not count. | |
| Count | Choice: Every entry, Paid entries only | Every entry | |
| When the limit is reached | Choice: Close the form, Take entries for a waiting list | Close the form | Waiting list entries get the Waitlist status and do not count towards the limit. Move one to another status to give it a place. |
| Message when the limit is reached | Formatted text | With a waiting list it is shown above the form. | |
| Message after joining the waiting list | Formatted text | ||
| Entries per logged in user | Whole number | ||
| Per user period | Choice: In total, Per day, Per week, Per month | In total | |
| Entries per IP address | Whole number | People in offices and schools can share one address. Prefer per user or per email limits when possible. | |
| Per IP period | Choice: In total, Per day, Per week, Per month | Per day | |
| Entries per email address | Whole number | ||
| Email field to count | A field of the form | ||
| Per email period | Choice: In total, Per day, Per week, Per month | In total | |
| Message when a visitor reaches their limit | Text | ||
| Staff who manage forms are not limited | On or off | On | |
| Who can use the form | Choice: Everyone, Logged in visitors, Selected roles | Everyone | |
| Roles | Roles | ||
| Message for others | Formatted text | ||
| Show a log in link | On or off | On |
Spam protection
| Setting | Kind | Default | Notes |
|---|---|---|---|
| Hidden trap field | On or off | On | Invisible to people and assistive technology; bots that fill it in are refused. |
| Refuse entries sent faster than (seconds) | Whole number | 3 | |
| Maximum entries per minute from one visitor | Whole number | 5 | Counted per form and per IP address hash. 0 turns it off. |
| Maximum web links in text answers | Whole number | ||
| Blocked words | List, one per line | ||
| Check entries with Akismet | On or off | Off | Only when the Akismet plugin is active. Sends the entry text, IP address and user agent to Automattic. |
| When an entry looks like spam | Choice: Refuse it, Keep it as spam for review | Refuse it |
Storage and privacy
| Setting | Kind | Default | Notes |
|---|---|---|---|
| Store entries | On or off | On | When off, each entry is kept only until its emails and integrations have run, then its values are removed. A short record without answers stays for 7 days for troubleshooting. |
| IP addresses | Choice: Site default, Store in full, Store shortened, Do not store | Site default | |
| Store the browser description | On or off | On | |
| Delete entries after (days) | Whole number | Empty keeps entries until you delete them. | |
| At the end of that period | Choice: Delete the entry, Remove personal answers, keep the rest | Delete the entry | |
| Roles that can see this form's entries | Roles | Empty means everyone with the View entries permission. |
Save and resume
| Setting | Kind | Default | Notes |
|---|---|---|---|
| Let visitors save and continue later | On or off | Off | |
| Button text | Text | ||
| Keep saved drafts for (days) | Whole number | 30 | |
| Offer to email the link to the visitor | On or off | On | |
| Message after saving | Formatted text | ||
| Keep signatures in saved drafts | On or off | Off |
Analytics
| Setting | Kind | Default | Notes |
|---|---|---|---|
| Send events to Google Analytics or Tag Manager | On or off | Off | Uses the analytics code already on your site (gtag or dataLayer). The plugin loads nothing itself. |
| Send to | Choice: dataLayer (Tag Manager), gtag, Both | dataLayer (Tag Manager) | |
| Event name for a successful submission | Name | form_submit | |
| Also send form start and step events | On or off | Off | |
| Google Ads conversion (AW-XXXX/label) | Text |
Advanced
| Setting | Kind | Default | Notes |
|---|---|---|---|
| CSS classes on the form | CSS classes | ||
| Turn off browser autofill for the whole form | On or off | Off | |
| Warn when the same answers were already sent in the last hour | On or off | Off |