The phone field collects an international phone number and stores the normalized number as a string.
Options and validation
| Option | Type | Default | Behavior |
|---|---|---|---|
defaultCountry | ISO 3166 alpha-2 string | browser timezone, locale, then the first country | Selects the country shown when the form opens |
required | boolean | false | Requires a possible phone number |
The respondent can change the selected country. The renderer checks that the number is possible; the authoritative normalization and phone validation happen on the server at submit.
Add a phone field
In the dashboard, select Add block, choose Phone, and optionally set the default country.
ts
const phoneField = {
id: "phone",
kind: "phone",
label: "Mobile number",
defaultCountry: "DE",
required: true,
} as const;A phone field can key a response limit, but a typed number is still an unverified self-claim.
Related
- Limit responses: Detect repeats from a phone answer or verified account.
- Respondents and identity: Understand claimed and verified identity.
- Fields: Compare the stored value for every field kind.