Kindly EditDocumentationTry the editor

Fields and layout

Every field type and its settings, with columns, steps, repeating groups, sections and one question at a time.

Every field type in the builder, grouped as the field library groups them, with its main settings. Settings marked (More) are on the More tab of the settings panel; the rest are on Field. Every field that takes an answer also has a Conditions tab: see Conditions and calculations. How to add, move and arrange fields is in Kindly Forms overview.

Settings most fields share#

Setting What it does
Label The question. Understands smartcodes.
Placeholder Words shown in an empty box.
Default value The answer it starts with. Smartcodes are filled in when the page is drawn, so {get.source} or {user.user_email} can prefill it.
Help Words under (or above, or in a tip beside) the field.
Required and Required message The field must be answered. The message falls back to the form's or the site's wording.
Name in entries (More) A shorter name for entries, emails and exports.
Label position (More) Form default, Top, Left, Right, Bottom or Hidden (still read by screen readers).
Field key (More) The name the answer is kept under: {inputs.KEY} in smartcodes, conditions and exports. It is made from the label, at most 48 characters, and is unique in the form. A key saved earlier is kept exactly as it is, since entries are stored under it.
Browser autofill (More) The autocomplete hint, such as email or postal-code, so browsers can fill it in.
Before the input, After the input (More) Words or a symbol in the box, such as $ or kg.
Read only (More) Shown but not editable.
Wrapper class, Input class (More) Classes for a site's own CSS.
Leave out of emails when empty (More) Skips the field in {all_data} when it has no answer.

Fields hidden by a condition are not required, are not checked and their answers are not kept.

Basics#

Field Main settings
Text Fewest characters, Most characters, Pattern (regular expression) and Pattern message, Input mask (US phone, zip, zip+4, date, time, SSN, card number, or My own: 9 a digit, a a letter, * either), Phone keyboard, Must be unique and Duplicate message, Calculation
Email Ask to type it twice and Second box label, Invalid email message, Only these domains, Not these domains, Must be unique
Name Parts: Title, First name, Middle name, Last name, Suffix, each switched on or off with its own label, placeholder, default, help and required setting
Paragraph Lines shown, Fewest characters, Most characters, Show characters left, Grow while typing
Number Lowest, Highest, Step (More), Exact digits (More), Number format (As typed, 1,234.56, 1,234, 1.234,56, 1.234, 1 234,56), Calculation, Hide the calculated box, Sets the quantity of (More, for a product)
Phone Country code picker, Default country, Guess the visitor's country, Countries offered (More), Check the number, Invalid number message
Web address Invalid address message
Address Parts (Street address, Apartment, suite or unit, City, State or province, Zip or postal code, Country), which can be reordered; Suggest addresses (No, Google Places, OpenStreetMap), Show a map, Use my location button (No, On click, On page load), Keep latitude and longitude, State as a list for US and Canada (More), Countries offered (More)
Date and time Format, Calendar picker, Earliest and Latest (today, +7 days, a date, or another answer such as {inputs.start}), Days not offered, Dates not offered, Only these dates, Choose a range, Choose several dates, Week starts on, Minutes step (all More)
Password Strength needed (Any, Medium, Strong), Ask to type it twice, Show password button. Passwords are never kept in entries.
Hidden value Default value. Not shown to visitors; useful with smartcodes such as {get.utm_source}.

Google Places needs a Google Maps key in Site settings.

Choices#

Field Main settings
Drop-down Choices, Placeholder, Type to search, Several can be chosen, Fewest choices, Most choices
Choose one Choices, Layout (List, In a row, Buttons, 2 to 5 columns), Add an "Other" choice, Go to the next step on choosing (More)
Choose several Choices, Layout, Fewest choices, Most choices, Add "Select all" (More), Add an "Other" choice, When ticked, copy (More: copy one answer, or a whole address, to another field while ticked, such as "Shipping address same as billing")
Country Placeholder, Default country, Type to search, Countries offered
Rating Choices (the levels and their words), Icon (Star, Heart, Thumb, Face, Bolt, Circle, Numbers, My own SVG), Chosen color, Not chosen color, Icon size, Show the words of the rating
Net Promoter Score Low end words, High end words, Scale starts at and Scale ends at (More, 0 to 10 by default)
Opinion scale From, To, Low end words, High end words
Choice grid Rows, Columns, Several per row, Every row needs an answer
Ranking Choices, Columns, Show position numbers, Number color, Start over button. Visitors drag the choices into order, or use the move buttons.
Linked drop-downs Levels and choices (CSV, first row names the levels), or Or read from a CSV address (for example a published Google Sheet). Each list offers only what fits the choice before it, such as country, then state, then city.

The choices list#

  • Drag choices to reorder them. Enter in a choice adds the next one, and pasting several lines adds a choice for each.
  • Chosen at the start ticks a choice for new visitors.
  • Separate values gives each choice a value kept in entries that differs from its words.
  • Numbers for calculations gives each choice a number that calculations read (for example, a price).
  • Pictures puts an image on each choice.
  • Limit stock sets how many of each choice can be taken. See Stock.
  • Edit as text shows the list as lines of words|value|number. Ready-made lists adds a whole list, such as countries, U.S. states, months, days of the week, satisfaction or agreement scales. Sort A to Z sorts it.
  • Shuffle the choices (More) shows them in a random order for each visitor.

Fill choices from takes the choices from somewhere else instead of the list: Posts or pages (any public content type), Categories or tags, People with accounts, Another form's answers, A CSV file or sheet, or A ready-made list. Each has its own settings, such as the words and value of each choice, the order and the most to show. When a source comes back empty, the typed list is used.

More#

Field Main settings
File upload Look (Drop area or Button), Button words, Kinds of files (images, PDF, documents, spreadsheets, CSV, presentations, audio, video, archives), Other extensions (More), Largest file (MB), Most files, Keep uploads in (More: Site setting, Private folder, Media Library, Both)
Image upload Image types, Largest file (MB), Most images, Show a preview, Crop before sending with Crop to a shape or an exact size, Shrink to at most (px) (More), Keep uploads in
Signature Pen color, Pad color, Pad height (px), Clear button words
Formatted text Lines shown, Buttons (Bold, Italic, Underline, Link, Bulleted list, Numbered list, Heading, Quote), Most characters
Slider Lowest, Highest, Step, Show the value, Sets the quantity of (More)
Color Suggested colors
Repeating rows A table people add rows to: Columns (each a Text, Email, Number, List, Date, Phone, Web address or Paragraph, with its own words, required setting, choices and a calculation in the row such as {qty} * {price}), Rows to start with, Most rows (0 for no limit), Add button words
Terms agreement Agreement words (links allowed), Show a checkbox, Full terms in a scroll box (More). Required by default.
Privacy consent Consent words. Always required.
Captcha Service: Site setting, Cloudflare Turnstile, Google reCAPTCHA or hCaptcha. Keys are set in Site settings. One per form.
Post picker Fill choices from (pages by default), Type to search, Several can be chosen
Suggestion box A text box with suggestions from Choices or Fill choices from; Only a suggestion is accepted
Save and finish later Button words. A button that saves the answers so far and gives a link to come back. See Limits, saving and spam. One per form.
Send button Words, Icon, Align, Size, Full width, While sending (More). Use it to place the button somewhere else, or to give it conditions. One per form.
Shortcode Shows another plugin's shortcode inside the form. Only people who may add code can add it.
Server hook Action name: runs a PHP action (do_action( name, $form )) where the field sits, for a developer's own output. Only people who may add code can add it.
Quiz result Keep: Points, Percent, Right answers of total, Grade or Personality. See Quizzes, form pages and post forms.

Layout and words#

Field Main settings
Section heading Label, Words under it, Heading level (H2 to H5), Align, Line under it
Words and links Words: text with links for the people filling in the form. {inputs.name} shows an answer as it is typed.
Divider A line.
Space Height (px).
Columns Fields side by side. See below.
Repeating group A set of fields people can repeat. See below.
Collapsible section Fields under a title that opens and closes. See below.
Page break Starts a new step. See below.

Payments#

The Payments group has Product or service, Amount to pay, Quantity, Subscription, Coupon, Payment method, Order summary and Total. They are described in Payments.

Columns#

A Columns field holds two to six columns of fields. The easiest way to make one is to drop a field near the left or right edge of another.

  • Columns sets each column's width with a slider, or a quick split. Add a column and Remove the last column; fields in a removed column move to the column before it.
  • Stack them on: Phones, Tablets and phones or Never.
  • Line up: Top, Middle or Bottom.
  • A field's Field actions menu has Take out of the columns. On the Columns field itself, Undo the columns, keep the fields puts its fields back one under another.

Columns can't go inside columns.

Steps#

Add a Page break where a new step should start. Everything before the first page break is the first step. A page break only goes at the top level of the form, not inside columns, sections or groups.

Each page break has Title of the next step, Words at the top of it, Next button words and Previous button words. A condition on a page break skips that whole step when it doesn't hold, up to the next page break.

How steps behave is set in Settings > Steps:

Setting What it does
Progress A bar, Step names, A bar with the percent or None
Show step titles Shows each step's title
First step title The first step's name (until the first page break). "Start" when empty.
Next button, Back button The form's default button words; a page break's own words win
Move between steps Slide, Fade or At once
Step names go to their step With Step names progress, people can click back to a step
Scroll to the top of the form on each step and Leave this much space above (px) Keeps the new step in view, below a fixed site header
Put the cursor in the first answer Focuses the first field of each step
Go on as soon as a one-choice question is answered Choosing an answer to the last Choose one question showing in a step goes on to the next step
Remember answers on this device if the page is closed Keeps the answers in this browser while someone fills the form in and puts them back when the page opens again. Files, passwords and card details are never kept. The copy is removed once the form is sent.

Each step is checked before Next goes on. The server checks every answer again when the form is sent.

To move on from one particular question, turn on Go to the next step on choosing (More) on that Choose one field.

Repeating rows and repeating groups#

There are two ways to let people add "another one":

  • Repeating rows (More) is a table. Each column is a simple kind of input, and each row can have a calculation. It suits line items and attendee lists.
  • Repeating group (Layout and words) repeats any set of simple fields you drop into it: text, email, number, choices, paragraph, web address, phone, date, country, hidden values, passwords, sliders, colors, headings, words, and columns of these. It suits "a child's name, age and allergies" for each child. Its settings are Groups to start with, Most groups (0 for no limit), Add button words, Remove button words and Title of each group ({n} is the group's number, as in Guest {n}).

Fields inside a repeating group can have conditions that read other fields in the same group. Repeating groups can't go inside each other.

Collapsible sections#

A Collapsible section holds any fields under a title. Shown as:

  • Accordion: a title that opens and closes, with Starts open and Close the others when opened.
  • Tab: sections next to each other become tabs.
  • Box: always open, framed as a group.

Words under the title describes what is inside. A section's condition hides every field in it.

One question at a time#

A form can show one question at a time, full screen, answered with the keyboard or a tap. Turn it on in Settings > One question at a time:

  • Ask one question at a time, Show progress, Show keyboard hints;
  • colors for Questions, Answers, Buttons and Background, and a Background picture.

Each question has an OK button; Enter also moves on (Shift+Enter makes a new line in a paragraph), and choosing an answer to a Choose one question moves on by itself. The up arrow button goes back. Each answer is checked before moving on, and questions hidden by conditions are skipped. Page breaks are not used in this look.

On a page, the Form element's Look setting (or the shortcode's style) can use this look, or the classic one, whatever the form says.

About this page

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

Type a word or phrase to search the full documentation.