> For the complete documentation index, see [llms.txt](https://doc.orbeon.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.orbeon.com/form-runner/component/us-phone.md).

# US phone

{% hint style="info" %}
Starting with Orbeon Forms 2026.1, use the [Phone Number](https://doc.orbeon.com/form-runner/component/phone.md) (`fr:phone`) component instead, which supports both US and international phone numbers. The `fr:us-phone` component remains supported for backward compatibility in existing forms.
{% endhint %}

## What it does

This component represents a US phone number. It:

* *validates* the stored format to make sure it contains exactly 10 digits.
* *removes* all `()*-[].#/'':` characters from the input string before storing the value.
* *formats* the value as `(123) 456-7890` when displaying the value, but only if the stored value is only made of digits.

## See also

* [Phone Number](https://doc.orbeon.com/form-runner/component/phone.md)
* [US Employer Identification Number (EIN)](https://doc.orbeon.com/form-runner/component/us-ein.md)
* [US Social Security Number (SSN)](https://doc.orbeon.com/form-runner/component/us-ssn.md)
* [US State](https://doc.orbeon.com/form-runner/component/us-state.md)
