Field types

Every question in a step is a field. Add field in the step editor opens a catalog of field types grouped into Popular, More and Content, with a search box above them; hovering a tile shows a live preview and what that type is good for, clicking one takes you to its settings. Each type's options are grouped into up to five tabs (Meta, Label, Config, Validations, Options), and only the tabs a type actually needs are shown. Change type in the same dialog swaps a field for another type (see Changing a field's type).

Some catalog tiles are presets of one underlying type: Short text, Email, Phone, Number and Website are all the text input with a different input type picked for you.

The welcome and thank-you screens aren't fields and have no tile: switch the welcome screen on under Settings, and write the text of both screens in Form copy.

Rating

A single numeric score from 1 up to Number of icons (default 5), shown as stars or icons the visitor taps.

  • Config: Number of icons, the top of the scale (e.g. 5 for a star rating, 10 for a finer scale); Icon and Size, the shape and size of the icons.

This is the type most surveys flag as their main evaluation question (Meta tab).

Opinion scale

A row of numbered buttons from Lowest score to Highest score (defaults to 1 to 10), the classic NPS layout. (Called "Matrix" in earlier versions; the grid of rows and columns is now the separate Matrix type below.)

For the classic 0 to 10 NPS scale, set Lowest score to 0 explicitly (it isn't the default).

  • Config: Lowest score, Highest score (the button range).

Checkbox group

Multiple-choice, multiple-select: respondents can pick any number of the options you define.

  • Options: each choice's label, translated per domain locale.

Radio group

Multiple-choice, single-select: same Options tab as checkbox group, but only one answer at a time.

  • Options: same as checkbox group.

Range slider

A draggable slider between Slider start and Slider end (defaults to 0 to 100), with optional end labels.

  • Config: Slider start, Slider end, Caption for the lowest value, Caption for the highest value.

Select

A dropdown with the options you define.

  • Options: same shape as checkbox/radio group's Options tab. Use Select over radio/checkbox group once the option list is long enough that inline buttons would crowd the form.

Textarea

Free-text response.

  • Validations: can be marked required.

This is the type most surveys flag as their main feedback-text question (Meta tab).

Text input

A single-line free-text field for short answers like a name, an email address, a phone number, a number or a link, where a multi-line textarea would look wrong. Input type on the Config tab decides what kind of answer it takes: it sets the keyboard a phone shows and what the browser offers to autofill, and every type except Text also checks the answer's format.

  • Config: Input type, one of:
    • Text (the Short text tile): anything goes.
    • Email: has to be a valid email address.
    • URL (the Website tile): has to be a web address with a real domain, like https://example.com. A visitor who types just example.com gets https:// added when they leave the field.
    • Number: has to be a number. A decimal comma is accepted too, and is saved as a point in languages that write decimals with a comma.
    • Phone: a country picker in front of the number; see Phone below.
  • Validations: can be marked required, same as textarea. The email check always runs on an email field: the tab only lets you edit the message a visitor gets when the address isn't valid. The website, number and phone checks show a built-in message in the visitor's language, which can't be edited.

Phone

The Phone tile is a text input with Input type set to Phone. The visitor gets a country picker (a flag and a calling code in front of the number), and the number is grouped the way that country writes it as they type. They can change the country in the picker, or type or paste a number starting with + and the country follows it. A number too short or too long for the chosen country isn't accepted.

  • Config: Default country, the country the picker starts on, shown only while Input type is Phone. Left on Visitor's country (automatic), the widget picks one from the survey's language and the visitor's browser settings. The example above does exactly that, so it starts on the country your own browser suggests.

The answer is saved with its calling code, like +44 7400 123456, however the visitor typed it.

Rich text

A content/instructional block, not a question: the visitor just reads it. Use it to add context, instructions, or a thank-you note between real questions. Nothing is captured or submitted for this field type.

  • Label (the tab is titled Content for this type): supports a small set of formatting (bold, italic, strikethrough, underline, line breaks and links), applied from the toolbar above the field, which also inserts an icon at the cursor. Links work the same way as in a consent field.

Rich text fields have a Meta tab (name/comment/field key, same as every other type) but skip the main evaluation/feedback checkboxes (see below) and have no Config, Validations, or Options tab: there's no answer to validate or configure.

Yes / No

A binary question, drawn as two buttons, thumbs up/down, or a tick and a cross.

  • Config: Style (buttons, thumbs or tick/cross); optional custom “Yes” caption and “No” caption.

Date

A calendar date, using the visitor's own browser date picker.

  • Config: Earliest date / Latest date, an optional allowed range.

Date range

Two dates, a start and an end (for a stay, a booking or an availability window). Both use the visitor's own browser date picker, and the end picker doesn't offer days before the chosen start.

  • Config: Earliest date / Latest date, an optional allowed range, applied to both dates.

A visitor picks both dates or neither: one date on its own is never accepted, even when the field isn't required, and the end can't be earlier than the start. The response shows the two dates as one range.

A single checkbox with your agreement text beside it. The text is the field's label, written in the same editor as a rich text block, so it can link to your terms or privacy policy: select the words, press Insert link in the toolbar and enter the address, which has to start with http:// or https://. Leave Link text empty and the address itself becomes the text. To change a link, select it and press Insert link again: what you apply replaces the selection. To remove one, select it and press Clear formatting, which also clears any bold or italic on the selection. Marking the field required means the box has to be ticked.

Keep square brackets out of a link's text and away from the start of a link: a bracket there breaks the link when the survey is saved.

Matrix

A grid: your rows down the side, your columns along the top, and one answer per row (a single column, several columns, or a short text, depending on the Answers per row setting).

  • Options: the rows and the columns, each translated per locale.
  • Config: Answers per row (one answer, several answers, or free text).

Bipolar matrix

Rows with two opposite poles, each rated on a numeric scale between them.

  • Options: the rows, each a left and a right pole.
  • Config: Scale starts at and Scale ends at, the scale between the poles (defaults to 1 to 7).

Rank order

Options the visitor sorts into their order of preference: by dragging, or with the up/down buttons on each row (the keyboard and touch route).

  • Options: the items to rank. The authored order is the starting order.

Group rank

Options the visitor sorts into groups, then orders within each group. Every option starts in a "not placed yet" pool; a row can be dragged into a group or moved with its own selector.

  • Options: the items, and the groups.

Constant sum

A number per option, and the widget insists they add up to your Total. A running total under the rows shows the visitor where they stand.

  • Options: the items to split the total across.
  • Config: Total, and whether to show the running total.

Group rating

A star rating for each of several items: the same icons, size and maximum as a single rating, once per row.

  • Options: the items to rate.
  • Config: Number of icons, Icon, Size (as for rating).

Contact form

Name, email, phone, company and a message in one block. Choose which of the six sub-fields to ask for and which of them are required; each can carry its own label, or use the built-in wording in the visitor's language. An enabled email sub-field is format-checked on its own, and the phone sub-field gets the same country picker as a phone field, starting on the visitor's own country.

  • Config: the sub-field list (ask / required / custom label per sub-field).

Signature

A drawing pad. The visitor signs with a finger or a mouse; the answer is the signature as an image, shown on the response detail page.

Section

A heading with an optional description that splits a long step into parts. Like rich text it is content, not a question: nothing is collected for it, and it never appears among a response's answers.

Section isn't offered in the Add field catalog for now. Sections already in a survey keep working and can still be edited.

The Options tab

Types built on a list (the choices of a single choice, multiple choice, dropdown, ranking or constant sum, a matrix's rows and columns, a group rank's groups, a bipolar matrix's pole pairs) edit it on the Options tab. Each list has its own heading and its own button: Add option, Add row, Add column or Add group; Remove next to an entry deletes it. A new entry arrives numbered ("Option 4", "Row 3") in every language of the domain, and a new bipolar row arrives with a pair of example poles (Slow / Fast, Complicated / Simple, Unfriendly / Friendly) for you to replace.

Changing a field's type

Change type, next to the field's current type at the top of the field dialog, takes you back to the catalog. Picking a type there starts the field over as that type: its own starter question, options and validation rules replace what you had, so it's quickest to settle the type before writing the question. Opened the catalog by mistake? Back to settings returns to the field as it was.

On a field that's already saved, one thing is kept: its field key, so the responses it has already collected stay attached to it. The main evaluation or main feedback flag goes to the new type if that type can take it and no other field has it.

The Validations tab

Every answer field can be marked required. Some types also check the answer itself, with nothing to switch on: an email, website, number or phone input checks its format (see Text input), and a date range needs both dates in the right order. Of those checks, only the email one has a message you can edit here. For a few types "required" means something more specific: a consent box has to be ticked, a matrix needs every row answered, a constant sum has to add up to its total, and a contact form checks each sub-field you marked required on its own.

A field saved earlier with the old Must be a valid email check turned on still shows that checkbox, so you can switch it off; new fields don't offer it.

Ticking required reveals a text box underneath it (the email check shows its box all the time): the message the visitor reads when that check stops them. It arrives already filled in, in every language the domain uses, so you can leave it alone and visitors still get a sensible message in their own language. Overwrite it whenever the default is too blunt for your survey: "We need your email to send the discount code" tells someone far more than "Field is required".

The message is a translated field like any other, so switch language with the selector above it to word it differently per language. It can also vary based on a previous answer (a conditional value), the same conditional mechanism used elsewhere in the editor. Most surveys never need this and can leave the single default.

The Visibility tab

A field can be shown only for some answers: a “What went wrong?” box after a low rating, or a follow-up for people who answered “No”. On the Visibility tab, click Add condition, pick an earlier question and set the answer to look for:

  • a rating, opinion scale or slider: equals, more than or less than a number;
  • a single choice or dropdown: is any of the options you pick;
  • a multiple choice: includes any of the options you pick;
  • a yes/no question: is Yes or No.

Only questions above the field can be picked, on an earlier step or higher up on the same one. With several conditions the field shows when all of them are met; with none it always shows. A field with conditions carries a Conditional chip in its step, and the survey preview next to the editor follows the conditions as you answer it.

A hidden field doesn't have to be answered, even when it's required, and an answer typed into it before it was hidden isn't sent. A step whose fields are all hidden is skipped. To hide a whole step, give the step its own conditions (see Steps). If the field is the main evaluation or main feedback question, a response where it stays hidden has no score or feedback text, and the editor warns about it.

This field shows only after a “No”

The Meta tab

Every field has a Meta tab with a name, a comment and a field key. The name and comment are for you only: visitors never see them, and the name is how the field is listed in its step. Leave the name empty and the field is named after its question when you save it.

A rating, opinion scale or slider also gets Use as the main evaluation, and a long or single-line text field gets Use as the main feedback. A survey has exactly one of each: tick the box on a second field and a warning names the field that has it now, and saving moves it over. Popup surveys are blocked from publishing without both; inline and on-site surveys only get a non-blocking warning. See Form types for the breakdown per type, and Steps for how the flags are assigned. Rich text and Section capture no answer, so those two checkboxes never appear for them.

Back to Survey creation