Address Field Validations

Validating the Checkout Page Address Fields

The address information submitted on the Checkout Page is important to ensure the order is shipped to the right destination. Validations are also performed on the field level.

Address Fields

The address form includes the following fields. Some fields are mandatory.

For more information about each field, open the sections below. See also Address Field Formats and Error Handling.

Field	Mandatory (Y/N)	Input
First Name	Yes	Maximum length is 40 Characters When unsupported characters are identified, the field is marked, and a notification is displayed.

Field	Mandatory (Y/N)	Input
Last Name	Yes	Maximum length is 40 Characters When unsupported characters are identified, the field is marked and a notification is displayed.

Field	Mandatory (Y/N)	Input
Email	Yes	For registered users, pre-filled and locked if email already provided. The following information defines what a valid email address is, based on: https://en.wikipedia.org/wiki/Email_address Valid email addresses must comply with the following: Uppercase and lowercase Latin letters (A–Z, a–z) (ASCII: 65–90, 97–122) Digits 0 to 9 (ASCII: 48–57) These special characters: # - _ ~ ! $ & ' + \| {} = “ / @ Character. (dot, period, full stop), ASCII 46, provided that it is not the first or last character, and provided that it does not appear consecutively (e.g. [email protected] is not allowed). Special Characters for non-English languages (accents).

Field

Mandatory (Y/N)

Input

Yes

For registered users, pre-filled and locked if email already provided.

The following information defines what a valid email address is, based on: https://en.wikipedia.org/wiki/Email_address

Valid email addresses must comply with the following:

Uppercase and lowercase Latin letters (A–Z,
a–z) (ASCII: 65–90, 97–122)
Digits 0 to 9 (ASCII: 48–57)
These special characters:
# - _ ~ ! $ & ' + | {} = “ / @
Character. (dot, period, full stop), ASCII 46, provided that it is not the first or last character, and provided that it does not appear consecutively (e.g. [email protected] is not allowed).
Special Characters for non-English languages (accents).

Field	Mandatory (Y/N)	Input
Country	Yes	Changing the default country requires that the customer fills out a delivery address that is different from the billing address. Country-specific address formatting and restricted country lists for some merchants.

Field

Mandatory (Y/N)

Input

Country

Yes

Changing the default country requires that the customer fills out a delivery address that is different from the billing address.

Country-specific address formatting and restricted country lists for some merchants.

Field	Mandatory (Y/N)	Input
Address Line1	Yes	Maximum length is 35 characters. When unsupported characters are identified, the field is marked and a notification is displayed. Allows letters, numbers, and specific special characters.

Field	Mandatory (Y/N)	Input
Address Line 2	Yes	Maximum length is 35 characters. Additional characters are not accepted. When Unsupported characters are identified the field is marked and notification displays. Allows letters, numbers, and specific special characters.

Field	Mandatory (Y/N)	Input
City/Suburb	Yes	Maximum length is 35 characters. Offers dropdown suggestions and dynamic city-region pairing for select countries. When unsupported characters are identified, the field is marked and a notification is displayed.

Field	Mandatory (Y/N)	Input
County/Province/State	Mandatory where applicable	A dropdown menu that includes counties, states, or provinces.

Field	Mandatory (Y/N)	Input
Zip/Postcode	Yes	Maximum length is 10 Characters When unsupported characters are identified, the field is marked and a notification is displayed. Can be configured per country whether this field is mandatory or not

Field	Mandatory (Y/N)	Input
Phone	Yes	Following characters are allowed: Numbers, “+”, “-“, “/”, “(“ and “)” Maximum length is 15 characters When unsupported characters are identified, the field is marked and a notification is displayed.

Address Field Formats and Error Handling

The address form contains address fields with the following formats and error notifications.

Field	Format	Error notifications
Address Line1	Maximum length is 35 characters. If the shipping method is one of the following: Express ExpressCourierWithoutSameDay Standard A PO Box won’t be accepted as an address without a delivery address. When unsupported characters are identified, the field is marked and a notification is displayed. Allows letters, numbers, and specific special characters. Additional format validation may be configured per country.	When the 36th character is attempted a notification is displayed: You’ve reached the maximum limit for Address Line 1 field. Please use Address Line 2 if you need more space” The following notification displays: Title: PO box address is not allowed on this shipping method Content: Dear Customer, The courier service you have selected requires a signature upon delivery. We are therefore unable to accept orders to a PO box address. To continue, please provide an alternative shipping address
Address Line 2	Maximum length is 35 characters. Additional characters are not accepted. If the shipping method is one of the following: Express ExpressCourierWithoutSameDay Standard A PO Box won’t be accepted as an address without a delivery address. When Unsupported characters are identified the field is marked and notification displays. Allows letters, numbers, and specific special characters. Additional format validation may be configured per country.	The following notification displays when a PO Box is added as an address to the shipping methods mentioned: Title: PO box address is not allowed on this shipping method Content: Dear Customer, The courier service you have selected requires a signature upon delivery. We are therefore unable to accept orders to a PO box address. To continue, please provide an alternative shipping address
City/Suburb	Maximum length is 35 characters. Offers dropdown suggestions and dynamic city-region pairing for select countries. Allows letters and hyphens.When unsupported characters are identified, the field is marked and a notification is displayed. Additional format validation may be configured per country.	When unsupported characters are identified, the field is marked in red and the checkout can not be completed until it is fixed.
Country	Changing the default country requires that the customer fills out a delivery address that is different from the billing address. Country-specific address formatting and restricted country lists for some merchants.
County/Province/State	A dropdown menu for some regions that includes counties, states, or provinces. For more details please see the Countries, States, and Provinces section.
Email	For registered users, pre-filled and locked if email already provided. The following information defines what a valid email address is, based on: https://en.wikipedia.org/wiki/Email_address Valid email addresses must comply with the following: Uppercase and lowercase Latin letters (A–Z, a–z) (ASCII: 65–90, 97–122) Digits 0 to 9 (ASCII: 48–57) These special characters: # - _ ~ ! $ & ' + \| {} = “ / @ Character. (dot, period, full stop), ASCII 46, provided that it is not the first or last character, and provided that it does not appear consecutively (e.g. [email protected] is not allowed). Special Characters for non-English languages (accents).	When an incorrect character is submitted, the field is marked in red, and an “X” is displayed on the right side. On mouseover, an “Email not Valid” tooltip is displayed
First Name	Maximum length is 40 Characters Cannot contain special characters or numbers. When unsupported characters are identified, the field is marked, and a notification is displayed. For more information about Special Characters, please see the Supported Characters section.	When unsupported characters are identified the field is marked in red and the checkout can not be completed until it is fixed.
Last Name	Maximum length is 40 Characters Cannot contain special characters or numbers. When unsupported characters are identified, the field is marked and a notification is displayed. For more information about Special Characters, please see the Supported Characters section.	When unsupported characters are identified the field is marked in red and the checkout can not be completed until it is fixed.
Phone	Following characters are allowed: Numbers, “+”, “-“, “/”, “(“ and “)” Maximum length is 15 characters When unsupported characters are identified, the field is marked and a notification is displayed. Drop-down menu of country prefixes can be enabled for applicable countries. Additional format validation may be configured per country. For more details please see the Phone Field Validations per Country section
Zip/Postcode	Maximum length is 10 Characters When unsupported characters are identified, the field is marked and a notification is displayed. There is a configuration per country whether this field is mandatory or not Additional format validation may be configured per country. For more details please see the Zip/Postcode Field Validations per Country section	When no input is available, a mouseover displays a tooltip: "Billing Zip/Postcode is required" When unsupported characters are identified the field is marked in red and the checkout can not be completed until it is fixed.

Phone Field Validations per Country

In addition to other field validations, a phone field format validation is configured for specific countries.

Specific validations can be set per Merchant.

Country	Field	Validation	Additional Info
Bahrain	Phone number	+973 prefix and 8 digits
	Phone number with Prefix	8 digits	When international prefix is enabled
France	Phone Number	The number provide must include a "06" or "07" prefix	Required by Chronopost
Kuwait	Phone number	+965 prefix and 8 digits
	Phone number with Prefix	8 digits	When international prefix is enabled
Oman	Phone number	+968 prefix and up to 8 digits
	Phone number with Prefix	8 digits	When international prefix is enabled
Qatar	Phone number	+974 prefix and up to 8 digits
	Phone number with Prefix	8 digits	When international prefix is enabled
Saudi Arabia	Phone number	+966 prefix and up to 10 digits
	Phone number with Prefix	9 digits	When international prefix is enabled
Switzerland	Phone number	Starts with +41, 9 digits.
United Arab Emirates	Phone number	+971 prefix and up to 9 digits
	Phone number with Prefix	9 digits	When international prefix is enabled

Zip/Postcode Field Validations per Country

In addition to the general field validations, a zip field format validation is configured for specific countries.