---
title: "Phone"
description: "Collect an international phone number with country-aware formatting and validation."
group: "Build forms"
order: 3
type: "reference"
parent: "fields"
keywords:
  - "phone"
  - "E.164"
  - "country"
  - "response limit"
updated: "2026-07-14"
---

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](/docs/response-limits): Detect repeats from a phone answer or verified account.
- [Respondents and identity](/docs/respondents): Understand claimed and verified identity.
- [Fields](/docs/fields): Compare the stored value for every field kind.