Add a phone number field to a form when you need a value submitted in a specific format. By default, a Phone Number field checks if the value entered is a valid phone number. Several types of phone number formats will be accepted. The field can be modified to allow a specific phone number format or any other alphanumeric format, including social security numbers and zip codes. Beyond that, you can use a regular expression (regex) to enforce virtually any format that you want. To add one to a form, click Phone in the form builder's Add Fields tab.

On the published form, a Phone field with the International format looks like this.

Standard field options

Select the field in the form builder to see its options in the Field Options tab. Most of them are in the Advanced section, so click Advanced to show them.

With Advanced open, the panel shows the options below. Validation Messages and Conditional Logic are separate sections under it. Click either heading to expand it.

• Field Type
• Required
• Unique
• Read Only
• Field Key
• CSS Layout Classes
• Label position
• Field Size

• Visibility
• Before & After Input
• Conditional logic
• Lookup value

Field-specific options

Max characters

Set a maximum number of characters to limit how many characters can be entered in the field. The Max Characters box is empty by default, so there's no limit.

Phone number format

Use the Phone number format option to make sure the field only accepts values in your specified format. The Format dropdown is set to None by default. The Phone field allows you to set the format in 3 ways:

• None: Checks the value against a general phone number pattern and saves it as typed.
• International: Use the international format to enter a phone number from another country. Users open the flag dropdown and pick a country, or type its name in the Search box at the top of that list. International phone fields need Formidable Forms Pro.
• Custom: Select this option if you require a specific phone format. In Formidable Forms Lite, the phone field performs basic regex validation. You can specify the expected format in the field description. With Formidable Forms Pro, type an input mask in the box that appears next to the Format dropdown, such as (999) 999-9999. Click the ... icon to see the mask symbols, such as 9 for a number and a for a letter. If you leave the box empty, the field goes back to None when you click Update. Check out the guide on customizing the format with an input mask.

Invalid format message

When the value entered isn't in the right format, the field shows its Invalid Format message. Email, Website/URL, Phone, and Number fields start with a message that tells the user what to enter:

• Email: "Enter a valid email address, like name@example.com"
• Website/URL: "Enter a valid web address, like https://example.com"
• Phone: "Enter a valid phone number"
• Number: "Enter a number"

To change it, open the field's Validation Messages section and edit Invalid Format.

For a Phone field with a format, the browser checks the value first and shows its own message, such as "Please match the requested format." The Invalid Format message shows under the field when the form setting Validate this form with javascript is on.

Confirmation fields

Use the Require Confirmation option to require a user to confirm that the information they entered in the phone field is correct. It is set to No Confirmation by default. Choose Inline to show a confirmation field next to the Phone field, or Below Field to show it underneath (1). Either choice adds a Show confirmation field label checkbox, which is checked at first. Uncheck Show confirmation field label to hide the confirmation field's label (2). If the two numbers don't match, the form shows "The entered values do not match" when it's submitted. Learn more about the confirmation field options.

Default values and field icons

Default Value and Placeholder Text are boxes in the field's Advanced section. Text in the Default Value box is submitted with the form unless the user changes it. Placeholder text is only a hint and is not submitted. Learn how to set a default value and how to set a placeholder in a Phone Number field.

Field action icons allow you to duplicate, delete, or move a field on the form builder page. See the field action icons article for more information.

Default option for international format

Set a default country for the phone number field when the international format is selected.

1. In the phone field options, set Format to International.
2. Click Advanced to open the Advanced section.
3. Enter the country prefix in the Default Value field. For example, to set the United Kingdom (UK) as the default option for phone numbers, add +44 as the default value.
   

   

4. Click Update to save your changes.

The default value sets the country of the Phone field only. A confirmation field starts with the visitor's country, found from their IP address. The Phone field opens with the prefix already typed in, such as +44. Its sample-number placeholder shows only when the field is empty.

Display a phone number field

Display the value submitted in a Phone Number field in a form's confirmation message, email, or View. Insert [x], where x is the ID or key of the Phone Number field.

Use international phone number format

When using the Phone field, you can format, validate, and store international phone numbers in the international format.

1. Add a phone field and set Format to International.
   

   

2. Once the form is published, the field starts with the flag of the visitor's country, found from their IP address. If you set a default country, the field starts with that country's flag instead. Users can either:
   • Use the country flag dropdown (1) to select the international format they want to apply to the phone number value.
   • Use the Search box (2), which suggests countries as they type.

   

3. When a country has been selected, a placeholder showing a sample number in that country's phone number format is automatically applied to the empty field.
4. When the user leaves the field, the value is changed to the full number with its country code and no spaces. It's saved that way. For example, +44 7400 123456 is saved as +447400123456.

Additional customizations

Display specific country flags

Display some specific country flags with the data-only-countries option in the Customize HTML.

Set a custom country order

Display the country flags in a custom order using the data-country-order option in the Customize HTML.

Related developer hook

• Load international phone input scripts with the frm_include_intlphone_in_minified_js hook.