Kindly EditDocumentationTry the editor

Limits and spam protection

Save and finish later, answer limits, schedules, sign-in, network, country and word rules, and every spam guard.

How to let people save a form and finish it later, how to limit when and how often a form takes answers, and how Kindly keeps automated sends out. Per-form choices are in the builder's Settings tab. Site-wide spam keys and defaults are in Kindly Edit > Forms > Settings.

Save and finish later#

Settings > Save and finish later lets people keep their answers and come back to them.

Setting What it does
Let people save their answers and come back Turns it on. "Add the Save and resume field where the link should be offered."
Also keep unfinished answers as they type Saves answers quietly in the background while someone fills the form in, without a button.
Signed-in people come back to their answers by themselves A signed-in person who saved finds their answers filled in the next time they open the form, without a link.
Keep saved answers for (days) Default 30. A daily task removes saved answers older than this.
Shown with the link The words above the link. Default: "Your answers are saved. Use this link to come back and finish:"
Offer to email the link Adds an email box so the person can send the link to themselves.
Email subject, Email That email. {resume_link} is the link.

To offer it, add the Save and finish later field (in the builder's Advanced fields) where the button should appear. Its Button words setting changes the label. A form can have one.

What visitors see: pressing the button saves the answers and shows the message, the link with Copy link, and, when emailing is on, a box with Email me the link. Opening the link fills the form in again with the saved answers.

What is kept and for how long:

  • Answers are kept under a long random token. Only a hash of the token is stored, so the link is the only way back in.
  • Files, signatures, passwords and captcha answers are never saved. People choose files again when they come back.
  • Sending the form deletes the saved answers. A daily task removes saved answers that haven't changed in the form's Keep saved answers for (days).
  • Saved and unfinished answers appear in Kindly Edit > Forms > Entries under Unfinished, marked Saved to finish later or Left part way.
  • Saving is protected by the page token, and has its own rate limit per network address.

Limits and schedule#

Settings > Limits and schedule. When a limit closes the form, its message replaces the form on the page, and answers sent anyway are refused with the same message. Each message can use smartcodes.

How many answers#

Setting What it does
Limit how many answers it takes Turns it on.
Most answers The number.
Counted In all, Each day, Each week (from Monday), Each month, Each year, From each network (per network address) or From each signed-in person.
When it is full Default: "This form has all the answers it can take."

Entries in Spam, in Trash, and those waiting for an email confirmation don't count. Days, weeks and months follow the site's time zone. From each signed-in person doesn't limit people who aren't signed in.

When it is open#

Setting What it does
Open only at certain times Turns it on.
Opens, Closes A date and time in the site's time zone. Either can be left empty.
Only on Days of the week. On other days the form shows Before it opens.
Before it opens Default: "This form isn't open yet."
After it closes Default: "This form is closed."

Who can send it#

Setting What it does
Only for people signed in Turns it on.
With these roles (none means any) Limits it to chosen roles.
For everyone else Default: "Sign in to fill in this form."

A form that isn't published (a draft or in the trash) takes no answers and shows nothing to visitors. People who may edit the form still see it in the page editor and in Preview.

Refusing certain answers#

These run when answers arrive. The visitor sees the message and the answers aren't stored.

Setting What it does
Refuse a form sent with nothing filled in On for new forms. Hidden fields and calculated fields don't count as answers. Default message: "Fill in at least one answer before sending."
Block or allow networks The list is Blocked or The only ones allowed. Addresses takes single addresses, ranges such as 198.51.100.0/24, and wildcards such as 203.0.113.*, separated by commas or lines.
Block or allow countries The list is Blocked or The only ones allowed, with a list of Countries.
Refuse answers with certain words Words, separated by commas. Matching ignores case and looks inside every answer.

How the country is found: from Cloudflare's country header when the site is behind Cloudflare, otherwise from ipinfo.io when Kindly Edit > Forms > Settings > Maps and location has an ipinfo.io token. When neither is available the country is unknown and country rules don't block anyone.

The network address is the connection's own address. Behind a proxy or load balancer, a developer can name the trusted header with the kindly_forms_ip_headers filter. Headers aren't trusted by default because they can be forged.

Spam protection#

Every form has these guards. Each form sets its own in Settings > Spam protection. The site's choices are in Kindly Edit > Forms > Settings > Spam, and are the defaults for forms that don't set their own.

Guard Form setting Site setting What it does
Hidden trap field Hidden trap field Hidden trap field A field people never see. Automated senders fill it in and are refused. On by default.
Page token Check the form was loaded by a browser Page token The page gets a signed token when someone starts using the form. A send without a valid token, sent less than 2 seconds after the token was made, or more than a day later is refused. On by default.
Rate limit Sends from one address: At most and Every (seconds) No more than this many sends from one network address in the window. Default 5 every 30 seconds.
Person check Person check Person check and its keys Cloudflare Turnstile, Google reCAPTCHA or hCaptcha.
Akismet Check answers with Akismet Check with Akismet and When Akismet says spam Asks Akismet about the name, email and text answers. "Needs the Akismet plugin set up." Keep it in Spam (the default) keeps a flagged entry in Spam and shows the normal confirmation; Refuse it keeps nothing and shows Looks automated.

What the visitor sees when a guard refuses a send comes from Settings > Messages: Looks automated (trap field), Page open too long (token: "This page has been open a long time. Reload it and send again."), Sent too quickly (a send within 2 seconds of the page token: "That was quick. Wait a moment and send it again."), Too many tries (rate limit) and Person check missing (captcha). Each form can reword them in its own Settings > Messages.

Refused sends aren't stored. Sends blocked by the trap field or the token are written to the form's log.

Person checks#

  1. In Kindly Edit > Forms > Settings > Spam, choose the Person check service and enter its Site key and Secret key:
    • Cloudflare Turnstile: also Look (Match the visitor's setting, Light or Dark).
    • Google reCAPTCHA: Version is Version 2 (a box to tick) or Version 3 (invisible, scored). Version 3 has Lowest score accepted, from 0 to 1 (default 0.5); higher blocks more.
    • hCaptcha.
  2. Turn on Add the check to every form to put the check on every form. With it on, the site's other guards that are on (trap field, token, Akismet) also apply to every form, whatever the form's own switches say.
  3. Or add it per form: set the form's Person check to a service, or add the Captcha field where the check should appear (its Service can be Site setting or a named service). None keeps a form without a check even when the site adds it everywhere.

The secret key is kept on the server. It is never shown again in the screen or sent to browsers. Without a site key the check isn't shown. If the service can't be reached, the send is refused and the visitor is asked to complete the check again.

Akismet#

With Akismet on and the Akismet plugin set up with a key, answers Akismet calls spam are kept quietly in Entries under Spam. The visitor sees the normal confirmation, and no emails or connections run. To recover a false positive, open the entry and change its status.

Marking an entry as spam later also gives back any stock it held. See Stock.

Without scripts#

A browser without JavaScript can still send a form, by a normal page post. It has no page token, so a form with the token on asks the person to reload and send again. With the token off, the trap field, rate limit and person check still apply.

Privacy and storage#

Settings > Privacy and storage controls what is kept. See After sending for Keep answers in Entries, network addresses and automatic deletion.

Analytics#

Settings, Analytics: Count views, starts and sends keeps the form's numbers for its report. With it on, a page that has Google Tag Manager (dataLayer) or Google Analytics 4 (gtag) also gets two events: kindly_form_submit when the form is sent and kindly_form_step when someone moves to another step (with step), each with the form's id and name (form_id, form_name, and formId, formTitle in the dataLayer). Event name replaces the kindly_form part, for example nche_form gives nche_form_submit.

About this page

Documents Kindly Edit 0.9.16. Source: includes/forms/resume.php, includes/forms/render.php, includes/forms/submit.php, assets/forms/builder-panels.js, assets/forms/admin.js. Theme choices and account permissions can change which controls appear.

Type a word or phrase to search the full documentation.