Text and contact fields

Six question types take typed input. They share the common question keys and differ in what they check and how the answer is stored.

Answer examples show an answer as Get responses returns it and as webhooks send it, without its question part. See Answers.

type	Name in the editor	Answer type
text	Text	text
number	Number	number
mail	Email	mail
phone_number	Phone number	phone_number
website	Website	website
date	Date	date

text

An open question answered in one line or in a larger text area.

Properties

Key	Type	Default	Description
description	string	""	Text under the question title.
multiple_lines	boolean	false	Big text area. Shows a multi-line field.
placeholder	string	not set	Custom placeholder text. Grey hint in the empty field, up to 150 characters. Without the key the form shows its default hint.

Validations

Key	Type	Default	Description
required	boolean	false	The respondent has to answer.
max_length	integer	not set	Max characters. 1 to 10000. The editor starts at 500 when the option is switched on.
pattern	string	not set	Answer validation. A regular expression, up to 500 characters. The whole answer has to match it.

The expression in pattern is anchored on both ends, so \d\d-\d\d\d accepts 12-345 and rejects x12-345. It is checked in the respondent’s browser with a time limit. An expression that does not compile or runs too long is skipped and the answer passes. Answers longer than 1000 characters are not checked.

Note

placeholder, max_length and pattern are available in the new form version.

Example

{
  "id": "Zr4kQ1xYb7Lm",
  "ref": "0f6c2d1e-8a47-4b6f-9c11-3f5a7d2e9b40",
  "type": "text",
  "title": "What is your postal code?",
  "properties": {
    "description": "",
    "multiple_lines": false,
    "placeholder": "12-345"
  },
  "validations": {
    "required": true,
    "max_length": 6,
    "pattern": "\\d\\d-\\d\\d\\d"
  },
  "media": false
}

Answer

{ "type": "text", "text": "12-345" }

number

A numeric field. The answer has to be a number.

Properties

Key	Type	Default	Description
description	string	""	Text under the question title.
mask	string	not set	Number mask. A format of up to 30 characters in which # stands for one digit, for example ### - ### - ###. The answer has to fill every #.

Validations

Key	Type	Default	Description
required	boolean	false	The respondent has to answer.
min_value	number	not set	Min number. Lowest accepted value.
max_value	number	not set	Max number. Highest accepted value, up to 9999999 in the editor.

Example

{
  "id": "h2Vt9PqLm0Xc",
  "ref": "7b1f4c9a-2d35-4e80-b6a1-90c2e7f4d615",
  "type": "number",
  "title": "How many people work in your team?",
  "properties": { "description": "" },
  "validations": { "required": false, "min_value": 1, "max_value": 500 },
  "media": false
}

Answer

The number is stored as a string.

{ "type": "number", "number": "12" }

mail

An e-mail address field. The form checks that the text has the form of an e-mail address.

It has no options of its own: properties.description and validations.required only.

Answer

{ "type": "mail", "mail": "anna@example.com" }

phone_number

A phone number field with a country selector. The form checks the number against the rules of the selected country.

Properties

Key	Type	Default	Description
description	string	""	Text under the question title.
country	string	"us", or "pl" in a form created in the Polish editor	Country selected when the question opens: a lowercase two-letter ISO 3166-1 code. The respondent can pick another country.

Validations: required only.

Answer

The number is stored in international format, with the country calling code.

{ "type": "phone_number", "phone_number": "+14155550132" }

website

A web address field. The form accepts an address with or without http:// or https://.

It has no options of its own: properties.description and validations.required only.

Answer

{ "type": "website", "website": "https://www.example.com" }

date

Three fields for the day, month and year. The form checks that the date exists, with years from 1000 to 3000.

It has no options of its own: properties.description and validations.required only.

Answer

The date is stored as DD/MM/YYYY, in every form language.

{ "type": "date", "date": "24/03/2027" }