---
sourceDocument: Xanadu ServiceNow AI Platform Administration
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/platform-administration

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu ServiceNow AI Platform Administration

ft:clusterId :

    - platadm

bundleId :

    - platadm

workflow :

    - Platform


---

# E.164 phone number field configuration

# E.164 phone number field configuration {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 9 minutes to read

Administrators can use the phone number system properties and dictionary attributes to
do certain things.
The system properties apply the configuration option to all phone number fields that do not
have a comparable dictionary attribute. The dictionary attributes apply the configuration
only to the phone number field it is added to. Since dictionary attributes take precedence
over system properties, administrators can set a global configuration with a property and
then apply exceptions on a field-by-field basis.  
Note:  
Alpha numeric characters are not allowed and is not considered as a valid phone number.

## Requiring territory format validation {#ariaid-title2}

By default, phone number fields require that a phone number match the display format of
the selected territory.

By default, phone number fields require that a phone number match the display format of the
selected territory. If a phone number does not match this format, the input box displays a red
line underneath the phone number or the whole box turns red, and users are prevented from saving
it.  
Figure 1. Phone e164 strict

Setting the glide.phone_number_e164.strict system property to
false or adding the pn_strict dictionary attribute
allows the phone number input box to display a green line underneath numbers that do not match
the territory format listed for the selected territory or the whole box turns green. You can use
the Other / Unknown territory to store otherwise invalid phone
numbers.  
Figure 2. Phone e164 not strict  
Warning:  
Switching from optional territory format validation to required territory format validation may result in some phone numbers failing validation altogether. In such cases, the E.164 phone number field displays an error message.

## Requiring entry of international format {#ariaid-title3}

By default, users can enter phone numbers in their territory's local format and do not
have to format the number for international dialing.

The phone number field automatically formats local phone numbers into E.164-compliant
international phone numbers when the user finishes editing the field. As long as the phone number
entered matches the territory's format for a local number, users can save the phone number.  
Figure 3. Phone e164 entry local  
Figure 4. Phone e164 display international

Changing the glide.phone_number_e164.allow_national_entry system property
or adding the pn_allow_national_entry dictionary attribute requires users to
enter a phone number in the territory's international format, which starts with the plus (+)
character. Users cannot save a locally formatted phone number, and the phone number input box
displays a red line underneath phone numbers without the proper international formatting.

## Configure the display of the local format {#ariaid-title4}

By default, an E.164 phone number field always displays phone numbers in an
international format.  
Figure 5. Phone e164 display international  
Change the E.164 phone number to use the local format in certain circumstances by [adding the following
system property](https://servicenow-prod.fluidtopics.net/r_0P5ICBCd42vTv64UVY9w#t_AddAPropertyUsingSysPropsList "Add or create a property to control system behavior."): {#c_ConfigureDisplayOfLocalFormat__simpletable_xsy_m3x_vz__entry__2}

| Property | Description |
|-|-|
| glide.phone_number_e164.display_national | * Type: string * Default value: false * Other possible values: * true or form: Displays phone numbers in a local format on forms, but displays an international format on lists. * all: Always displays phone numbers in a local format. * user: Only displays phone numbers in a local format when the phone number matches the local setting of the current user. * false: Does not display phone numbers in local format. {#c_ConfigureDisplayOfLocalFormat__ul_nz5_lnc_pt} {#c_ConfigureDisplayOfLocalFormat__ul_dbb_jnc_pt} |
[Table 1.]

{#c_ConfigureDisplayOfLocalFormat__simpletable_xsy_m3x_vz}Select one of the possible values to determine how the system handles the E.164 phone number.  
You can also [add the
following dictionary attribute](https://servicenow-prod.fluidtopics.net/bHhNzfdSmx1ltB2o4HpOag "Modify dictionary entries by configuring a field on a form or from the Dictionary module.") to a specific field to override the system property:{#c_ConfigureDisplayOfLocalFormat__simpletable_nn2_x3x_vz__entry__2}

| Dictionary attribute | Description |
|-|-|
| pn_display_national | Overrides the glide.phone_number_e164.display_national property setting for how an E.164 phone number field displays phone numbers. Available values are identical to those described for the glide.phone_number_e164.display_national property. * Type: string * Default value: false * Example:pn_display_national=all {#c_ConfigureDisplayOfLocalFormat__ul_hz5_gjj_3r} |
[Table 2.]

{#c_ConfigureDisplayOfLocalFormat__simpletable_nn2_x3x_vz}

## Configure the display of territory labels {#ariaid-title5}

A property controls how territory labels are displayed.

You can display territory labels next to the number in an E.164 phone number field by setting the system property or adding the dictionary attribute. This display is useful if the territory selector choice list is turned off and
you want the user to see the territory for the entered phone number.  
Figure 6. E164 phone display territory labels

Enabling territory labels also displays the phone territory in lists.  
[Add the following system property](https://servicenow-prod.fluidtopics.net/r_0P5ICBCd42vTv64UVY9w#t_AddAPropertyUsingSysPropsList "Add or create a property to control system behavior.") to display the territory label next to the number in an E.164 phone number. {#c_ConfigDisplayOfTerritoryLabel__simpletable_xsy_m3x_vz__entry__2}

| Property | Description |
|-|-|
| glide.phone_number_e164.display_territory_text | Determines when an E.164 phone number field displays a territory label. * **Type**: string * **Default value**: read-only * **Other possible values** : * all: Displays the territory label. * national: Displays the territory label only if the phone number is in local format. * read-only: Displays the territory label in read-only mode, regardless of whether the number is in local or international format. * read-only-national: Displays the territory label in read-only mode only if the number is in local format. * list: Displays the territory label in a list. * list-national: Displays the territory label in a list if the number is in national format. * none: Does not display the territory label. {#c_ConfigDisplayOfTerritoryLabel__ul_nd4_n1j_3r} {#c_ConfigDisplayOfTerritoryLabel__ul_qh3_pnc_pt} |
[Table 3.]

{#c_ConfigDisplayOfTerritoryLabel__simpletable_xsy_m3x_vz}  
You can also [add the
following dictionary attribute](https://servicenow-prod.fluidtopics.net/bHhNzfdSmx1ltB2o4HpOag "Modify dictionary entries by configuring a field on a form or from the Dictionary module.") to a specific field to override the system property:{#c_ConfigDisplayOfTerritoryLabel__simpletable_nn2_x3x_vz__entry__2}

| Dictionary attribute | Description |
|-|-|
| pn_display_territory_text | Overrides the glide.phone_number_e164.display_territory_text property that defines when a phone number field displays a territory label. Available values are identical to those described previously for the glide.phone_number_e164.display_territory_text property. * Type: string * Default value: read-only * Example:pn_display_territory_text=all {#c_ConfigDisplayOfTerritoryLabel__ul_l4b_vjj_3r} |
[Table 4.]

{#c_ConfigDisplayOfTerritoryLabel__simpletable_nn2_x3x_vz}

## Configure the international direct dialing prefixes {#ariaid-title6}

A property is available to control the display of prefixes.

You can enable the display of the international direct dialing prefix, which appears between the territory selector choice list and the input box for an E.164 phone number field on forms, by setting the system property or adding
the dictionary attribute.  
Figure 7. E164 phone display idd ![Phone display with the international direct dialing prefix before the phone number field]()  
[Add the following system property](https://servicenow-prod.fluidtopics.net/r_0P5ICBCd42vTv64UVY9w#t_AddAPropertyUsingSysPropsList "Add or create a property to control system behavior.") to display the international direct dialing prefix. {#c_ConfigInternatlDirDialPrefixDisp__simpletable_xsy_m3x_vz__entry__2}

| Property | Description |
|-|-|
| glide.phone_number_e164.display_users_idd | Determines whether to display the international direct dialing prefix between the territory selector choice list and the input box on forms. * Type: true \| false * Default value: false {#c_ConfigInternatlDirDialPrefixDisp__ul_itl_ync_pt} |
[Table 5.]

{#c_ConfigInternatlDirDialPrefixDisp__simpletable_xsy_m3x_vz}  
You can also [add the following dictionary attribute](https://servicenow-prod.fluidtopics.net/bHhNzfdSmx1ltB2o4HpOag "Modify dictionary entries by configuring a field on a form or from the Dictionary module.") to a specific field to override the system property:{#c_ConfigInternatlDirDialPrefixDisp__simpletable_nn2_x3x_vz__entry__2}

| Dictionary attribute | Description |
|-|-|
| pn_display_users_idd | Overrides the glide.phone_number_e164.display_users_idd property that determines whether to display the international direct dialing prefix between the territory selector choice list and the input box on forms. Available values are identical to those described above for the glide.phone_number_e164.display_users_idd property. * Type: true \| false * Default value: false * Example:pn_display_users_idd=false {#c_ConfigInternatlDirDialPrefixDisp__ul_lkz_yjj_3r} |
[Table 6.]

{#c_ConfigInternatlDirDialPrefixDisp__simpletable_nn2_x3x_vz}

### Configure the phone territory selector choice list {#ariaid-title7}

By default, an E.164 phone number field always displays the phone territory that is associated with the phone number.

Changing the system property or adding the dictionary attribute hides the territory selector
choice list. If the territory selector choice list is hidden, users can only enter a local or
national number.  
Figure 8. Phone e164 hide selector  
[Add the following system property](https://servicenow-prod.fluidtopics.net/r_0P5ICBCd42vTv64UVY9w#t_AddAPropertyUsingSysPropsList "Add or create a property to control system behavior.") to show or hide the territory selector choice list. {#c_ConfigPhneTerrSelChoiceList__simpletable_xsy_m3x_vz__entry__2}

| Property | Description |
|-|-|
| glide.phone_number_e164.display_territory_selector | Determines whether to display the territory selector choice list. Hiding the territory selector choice list restricts users to entering only local or national phone numbers. * Type: true \| false * Default value: true {#c_ConfigPhneTerrSelChoiceList__ul_gr3_4nc_pt} |
[ ]

{#c_ConfigPhneTerrSelChoiceList__simpletable_xsy_m3x_vz}  
You can also [add the following dictionary attribute](https://servicenow-prod.fluidtopics.net/bHhNzfdSmx1ltB2o4HpOag "Modify dictionary entries by configuring a field on a form or from the Dictionary module.") to a specific field to override the system property:{#c_ConfigPhneTerrSelChoiceList__simpletable_nn2_x3x_vz__entry__2}

| Dictionary attribute | Description |
|-|-|
| pn_display_territory_selector | Overrides the glide.phone_number_e164.display_territory_selector property setting that determines whether to display the territory selector choice list. Available values are identical to those described above for the glide.phone_number_e164.display_territory_selector property. * Type: true \| false * Default value: true * Example: pn_display_territory_selector=false {#c_ConfigPhneTerrSelChoiceList__ul_gtp_4jj_3r} |
[ ]

{#c_ConfigPhneTerrSelChoiceList__simpletable_nn2_x3x_vz}

## E.164 phone number field system properties {#ariaid-title8}

Several properties are available to configure E.164 phone number fields.
Note:  
To open the System Properties \[sys_properties\] table, enter <kbd class="ph userinput">sys_properties.list</kbd> in the navigation filter.
{#r_E.164PhoneNumFieldSysProps__table_jlx_ny3_3r__entry__2}

| Property | Description |
|-|-|
| glide.phone_number_e164.strict | Determines whether all phone number fields must match the display format for the selected territory. When the value is true, the phone number input field displays a red line underneath the phone numbers that do not match the format for the selected territory. Users cannot save the phone number. When the value is false, the phone number input field displays a green line underneath phone numbers that do not match the format for the selected territory. Users can save the phone number. The territory selector choice list offers the option to select an Other / Unknown territory format. * Type: true \| false * Default value: true * Location: [Add](https://servicenow-prod.fluidtopics.net/r_0P5ICBCd42vTv64UVY9w#t_AddAPropertyUsingSysPropsList "Add or create a property to control system behavior.") to the System Properties \[sys_properties\] table. {#r_E.164PhoneNumFieldSysProps__ul_pq1_1nc_pt} |
| glide.phone_number_e164.allow_national_entry | Determines whether users can enter phone numbers in the local format or whether they must enter phone numbers in international format. When true, users can enter phone numbers in the local format for the selected territory. When false, users must enter phone numbers in the international format for the selected territory. * Type: true \| false * Default value: true * Location: [Add](https://servicenow-prod.fluidtopics.net/r_0P5ICBCd42vTv64UVY9w#t_AddAPropertyUsingSysPropsList "Add or create a property to control system behavior.") to the System Properties \[sys_properties\] table. {#r_E.164PhoneNumFieldSysProps__ul_icv_hnc_pt} |
| glide.phone_number_e164.display_national | Determines whether to display E.164 phone numbers in local format. * Type: string * Default value: false * Other possible values: * true or form: Displays phone numbers in a local format on forms, but displays an international format on lists. * all: Always displays phone numbers in a local format. * user: Only displays phone numbers in a local format when the phone number matches the local setting of the current user. The local setting of the current user is determined by the location associated with the [user record](https://servicenow-prod.fluidtopics.net/thbYJONgwTZEEp6vKKQOxw "You can add a user to your instance to enable them to log in and use designated application features."). * false: Does not display phone numbers in local format. {#r_E.164PhoneNumFieldSysProps__ul_nz5_lnc_pt} * Location: [Add](https://servicenow-prod.fluidtopics.net/r_0P5ICBCd42vTv64UVY9w#t_AddAPropertyUsingSysPropsList "Add or create a property to control system behavior.") to the System Properties \[sys_properties\] table. {#r_E.164PhoneNumFieldSysProps__ul_dbb_jnc_pt} |
| glide.phone_number_e164.display_territory_selector | Determines whether to display the territory selector choice list. Hiding the territory selector choice list restricts users to entering only local or national phone numbers. * Type: true \| false * Default value: true * Location: [Add](https://servicenow-prod.fluidtopics.net/r_0P5ICBCd42vTv64UVY9w#t_AddAPropertyUsingSysPropsList "Add or create a property to control system behavior.") to the System Properties \[sys_properties\] table. {#r_E.164PhoneNumFieldSysProps__ul_gr3_4nc_pt} |
| glide.phone_number_e164.display_territory_text | Determines when an E.164 phone number field displays a territory label. * Type: string * Default value: read-only * Other possible values: * all: Always displays the territory label. * national: Displays the territory label only if the phone number is in local format. * read-only: Displays the territory label in read-only mode, regardless of whether the number is in local or international format. * read-only-national: Displays the territory label in read-only mode only if the number is in local format. * list: Displays the territory label in a list. * list-national: Displays the territory label in a list if the number is in national format. * none: Does not display the territory label. {#r_E.164PhoneNumFieldSysProps__ul_nd4_n1j_3r} * Location: [Add](https://servicenow-prod.fluidtopics.net/r_0P5ICBCd42vTv64UVY9w#t_AddAPropertyUsingSysPropsList "Add or create a property to control system behavior.") to the System Properties \[sys_properties\] table. {#r_E.164PhoneNumFieldSysProps__ul_qh3_pnc_pt} |
| glide.phone_number_e164.display_users_idd | Determines whether to display the international direct dialing prefix between the territory selector choice list and the input field on forms. * Type: true \| false * Default value: false * Location: [Add](https://servicenow-prod.fluidtopics.net/r_0P5ICBCd42vTv64UVY9w#t_AddAPropertyUsingSysPropsList "Add or create a property to control system behavior.") to the System Properties \[sys_properties\] table. {#r_E.164PhoneNumFieldSysProps__ul_itl_ync_pt} |
[Table 7. e.164 phone number field system properties]

{#r_E.164PhoneNumFieldSysProps__table_jlx_ny3_3r}

## E.164 phone number field dictionary attributes {#ariaid-title9}

You can override the global system property with certain dictionary
attributes.
{#r_E.164PhoneNumFieldDictAttribs__table_rrg_nhj_3r__entry__2}

| Dictionary attribute | Description |
|-|-|
| pn_strict | Overrides the glide.phone_number_e164.strict property setting that requires all phone number entries match the format for the selected territory. Available values are identical to those described for the glide.phone_number_e164.strict property. * Type: true \| false * Default value: true * Example:pn_strict=false {#r_E.164PhoneNumFieldDictAttribs__ul_ul4_g3j_3r} |
| pn_allow_national_entry | Overrides the glide.phone_number_e164.allow_national_entry property setting that determines whether users can enter phone numbers in the local format or whether they must enter phone numbers in international format. Available values are identical to those described for the glide.phone_number_e164.allow_national_entry property. * Type: true \| false * Default value: true * Example:pn_allow_national_entry=false {#r_E.164PhoneNumFieldDictAttribs__ul_wyl_1jj_3r} |
| pn_display_national | Overrides the glide.phone_number_e164.display_national property setting for how an E.164 phone number field displays phone numbers. Available values are identical to those described for the glide.phone_number_e164.display_national property. * Type: string * Default value: false * Example:pn_display_national=all {#r_E.164PhoneNumFieldDictAttribs__ul_hz5_gjj_3r} |
| pn_display_territory_selector | Overrides the glide.phone_number_e164.display_territory_selector property setting that determines whether to display the territory selector choice list. Available values are identical to those described for the glide.phone_number_e164.display_territory_selector property. * Type: true \| false * Default value: true * Example: pn_display_territory_selector=false {#r_E.164PhoneNumFieldDictAttribs__ul_gtp_4jj_3r} |
| pn_display_territory_text | Overrides the glide.phone_number_e164.display_territory_text property that defines when a phone number field displays a territory label. Available values are identical to those described for the glide.phone_number_e164.display_territory_text property. * Type: string * Default value: read-only * Example:pn_display_territory_text=all {#r_E.164PhoneNumFieldDictAttribs__ul_l4b_vjj_3r} |
| pn_display_users_idd | Overrides the glide.phone_number_e164.display_users_idd property that determines whether to display the international direct dialing prefix between the territory selector choice list and the input box on forms. Available values are identical to those described for the glide.phone_number_e164.display_users_idd property. * Type: true \| false * Default value: false * Example:pn_display_users_idd=false {#r_E.164PhoneNumFieldDictAttribs__ul_lkz_yjj_3r} |
[Table 8. e.164 phone number field dictionary attributes]

{#r_E.164PhoneNumFieldDictAttribs__table_rrg_nhj_3r}