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.
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 |
| 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 |
| 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 |
| 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 Counties, States, and Provinces section. | |
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:
| 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 |
| When unsupported characters are identified the field is marked in red and the checkout can not be completed until it is fixed. |
Last Name |
| When unsupported characters are identified the field is marked in red and the checkout can not be completed until it is fixed. |
Phone |
| |
Zip/Postcode |
| 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 |
Phone Validation Flow in Checkout
Why We Introduced This Change
Shoppers often enter phone numbers in inconsistent ways—missing country codes, typing leading zeros, or using invalid formats. This leads to:
Failed deliveries or shipping delays.
Checkout errors that block order completion.
To solve this, we’ve launched a new phone validation flow (for merchants who use the dropdown phone field). It ensures all shopper phone numbers are collected, validated, and stored in a consistent, global format.
What’s New for Merchants
Structured validation: Phone numbers are automatically checked and formatted to international E.164 standards on the server side.
Real-time feedback: Shoppers still receive clear guidance while typing, but validation that previously failed on the client side now succeeds after being corrected on the backend.
Data accuracy: Stored numbers are always valid, deliverable, and standardized.
Configuration: You can enable validation globally or per-country.
Shopper Experience in Checkout
Before (old flow):
Shopper types 09876543211 → checkout rejects the number immediately on the client side.
Now (new flow):
Shopper types 09876543211 (UK) → shopper sees no blocking error; system auto-removes the leading zero on the server side and saves as +449876543211.
Shopper types invalid characters (98765abc321) → shopper receives a clear error message with guidance to fix the input.
Configuration and Enablement
This feature applies only if you use the dropdown phone field in checkout. If you’d like to enable this feature, contact your Global-e representative.
Setting | Behavior |
---|---|
IsPhoneNumbersNewFlow = false | Current validation logic remains. |
IsPhoneNumbersNewFlow = true | New validation applies to all countries. |
IsPhoneNumbersNewFlow = per-country | New validation applies only in selected markets. |
UseCustomPhoneNumberValidation = true | Merchant-specific rules override global validation. |
Examples of Allowed Inputs
The following table shows examples of allowed inputs:
Shopper Input | Selected Country | Saved Output | Accepted? |
---|---|---|---|
9876543211 | USA | +19876543211 | Yes |
02081234567 | UK | +442081234567 | Yes |
20812 34567 | UK | +442081234567 | Yes |
08034567890 | Japan | +818034567890 | Yes |
The following figure shows the error message that occurs when you leave a mandatory field blank or enter an invalid number.

The following figure shows how correct information looks.

Shopper Error Messages
If a shopper enters an invalid number, the following error message is displayed.
“Invalid phone number format. Expected phone country: {Country Name}. Please adjust your number accordingly.”
Benefits for Merchants
📦 Fewer failed shipments due to invalid numbers.
💬 Clear shopper guidance reduces support tickets.
📊 Clean, standardized phone data across your orders.
🚀 Proven impact on conversion rates by removing friction.
Timeline and Rollout
Q2 2025: Library implementation & QA.
Q3 2025: Available on demand.
Q1 2026: General availability for all merchants using dropdown phone input with new validation.
Note
We strongly encourage merchants still using free-text phone fields to migrate to dropdown phone fields to benefit from this improvement.
Roadmap – Planned for End of November
We are enhancing validation to provide country-specific error handling:
Localized error messages: Shoppers will see validation errors tailored to the selected country.
Clear guidance & examples: Each message will include examples in the correct local format for clarity.
Customization per Merchant × Country: Merchants will have the flexibility to customize error messages per country.
New UI Experience:
Easy country search by name or code.
Restricts input to digits only for cleaner validation.
Zip/Postcode Field Validations per Country
In addition to the general field validations, a zip field format validation is configured for specific countries.
Specific validations can be set per Merchant.
Country | Field | Validation | Additional Info |
---|---|---|---|
Albania | Post Code | 4 digits | |
Algeria | Post Code | 5 digits | |
Andorra | Post Code | 2 Capital letters and 3 digits (AB123) | |
Angola | Post Code | Field Optional | |
Antigua and Barbuda | Post Code | Field Optional | |
Argentina | Post Code | 4 digits | |
Armenia | Post Code | 4 digits | |
Aruba | Post Code | Field Optional | |
Austria | Post Code | 4 digits | |
Australia | Post Code | 4 digits | |
Azerbaijan | Post Code | 4 digits | |
Bahamas | Post Code | Field Optional | |
Bahrain | Post Code | Field Disabled. Sending "00000" | |
Belarus | Post Code | 6 digits | |
Belize | Post Code | Field Optional | |
Belgium | Post Code | 4 digits | |
Benin | Post Code | Field Optional | |
Bolivia | Post Code | Field Optional | |
Bonaire, Saint Eustatius and Saba | Post Code | Field Optional | |
Botswana | Post Code | Field Optional | |
Bouvet Island | Post Code | Field Optional | |
Bulgaria | Post Code | 4 digits | |
Burkina Faso | Post Code | Field Optional | |
Burundi | Post Code | Field Optional | |
Central African Republic | Post Code | Field Optional | |
Cambodia | Post Code | 6 digits | |
Cameroon | Post Code | Field Optional | |
Canada | Post Code | 5 or 6 digits | In one of the following formats: A1A 1A1 or A1A 1A |
Chad | Post Code | Field Optional | |
Chile | Post Code | 7 digits | |
China | Post Code | 6 digits | |
Colombia | Post Code | 6 digits | |
Comoros | Post Code | Field Optional | |
Congo | Post Code | Field Optional | |
Congo, Democratic Republic | Post Code | Field Required | |
Cook Islands | Post Code | Field Optional | |
Costa Rica | Post Code | 5 digits | |
Cote D'Ivoire (Ivory Coast) | Post Code | Field Optional | |
Croatia | Post Code | 5 digits | |
Curacao | Post Code | Field Optional | |
Cyprus | Postal Code | 4 digits | |
Czech Republic | Post Code | 5 digits | |
Denmark | Post Code | 4 digits | |
Djibouti | Post Code | Field Optional | |
Dominica | Post Code | Field Optional | |
East Timor | Post Code | Field Optional | |
Ecuador | Post Code | 6 digits | |
Egypt | Post Code | 5 digits | |
Equatorial Guinea | Post Code | Field Optional | |
Eritrea | Post Code | Field Optional | |
Estonia | Post Code | 5 digits | |
Fiji | Post Code | Field Optional | |
Finland | Post Code | 5 digits | |
France | Post Code | 5 digits | |
French Southern Territories | Post Code | Field Optional | |
Gabon | Post Code | Field Optional | |
Gambia | Post Code | Field Optional | |
Germany | Post Code | 5 digits | |
Ghana | Post Code | Field Required | |
Greece | Post Code | 5 digits | In the format XXX XX or XXXXX |
Grenada | Post Code | Field Optional | |
Guatemala | Post Code | 5 digits | |
Guinea | Post Code | Field Required | |
Guyana | Post Code | Field Optional | |
Hong Kong | Post Code | Field Disabled | |
Hungary | Post Code | 4 digits | |
Iceland | Post Code | 3 digits | |
India | Post Code | 6 digits | |
Indonesia | Post Code | 5, 6 digits | |
Ireland | Post Code | 7 digits or 7 characters (Eircode) | |
Israel | Post Code | 7 digits | |
Italy | Post Code | 5 digits | |
Jamaica | Post Code | Field Optional | |
Japan | Post Code | 7 digits (XXXXXXX or (XXX-XXXX) |
|
Kazakhstan | Post Code | 6 digits | |
Kiribati | Post Code | Field Optional | |
Korea (North) | Post Code | Field Optional | |
Kuwait | Post Code | 5 digits | |
Liberia | Post Code | Field Optional | |
Libya | Post Code | Field Optional | |
Luxembourg | Post Code | 4 digits | |
Macau | Post Code | Field Disabled. Sending "999087" | |
Malawi | Post Code | Field Optional | |
Malaysia | Post Code | 5 digits | Field Optional |
Mali | Post Code | Field Optional | |
Mauritania | Post Code | Field Optional | |
Mauritius | Post Code | Field Required | |
Mexico | Post Code | 5 digits | |
Moldova | Post Code | 4 digits | |
Monaco | Post Code | Field Disabled. Sending "98000" | |
Mongolia | Post Code | 5 digits | |
Montenegro | Post Code | 5 digits | |
Montserrat | Post Code | Field Required | |
Morrocco | Post Code | 5 digits | |
Namibia | Post Code | Field Required | |
Nauru | Post Code | Field Required | |
Nigeria | Post Code | 6 digits | |
New Zealand | Post Code | 4 digits | |
Netherlands | Post Code | 4 digits and 2 letters (1235 AB) | |
Netherlands Antilles | Post Code | Field Optional | |
Niue | Post Code | Field Required | |
Northern Macedonia | Post Code | 4 digits | |
Norway | Post Code | 4 digits | |
Oman | Post Code | 3 digits | |
Panama | Post Code | Field Required | |
Philippines | Postal Code | 4 digits | |
Poland | Post Code | 5 digits (XX-XXX) | |
Portugal | Post Code | 7 digits (XXX-XXXX) | |
Qatar | Post Code | Field Disabled. Sending "00000" | |
Reunion | Post Code | 5 digits | |
Romania | Post Code | 6 digits | |
Russia | Post Code | 6 digits | |
Rwanda | Post Code | Field Required | |
Saint Kitts and Nevis | Post Code | Field Required | |
Saint Lucia | Post Code | Field Required | |
Sao Tome and Principe | Post Code | Field Optional | |
Saudi Arabia | Post Code | Field Disabled. Sending "00000" | |
Senegal | Post Code | 5 digits | |
Serbia | Post Code | 5 digits | |
Seychelles | Post Code | Field Optional | |
Sierra Leone | Post Code | Field Optional | |
Singapore | Post Code | 6 digits | |
Sint Maarten | Post Code | Field Optional | |
Slovenia | Post Code | 4 digits | |
Solomon Islands | Post Code | Field Optional | |
Somalia | Post Code | Field Optional | |
South Africa | Post Code | 4 digits | |
South Korea | Post Code | 5 digits no dash | |
South Cudan | Post Code | Field Optional | |
Spain | Post Code | 5 digits | |
Sri Lanka | Post Code | 4 digits | |
Suriname | Post Code | Field Optional | |
Syria | Post Code | Field Optional | |
Sweden | Post Code | 5 digits | |
Tanzania | Post Code | Field Required | |
Thailand | Post Code | 5 digit | |
Togo | Post Code | Field Optional | |
Tokelau | Post Code | Field Optional | |
Tonga | Post Code | Field Optional | |
Trinidad and Tobago | Post Code | Field Optional | |
Tunisia | Post Code | 4, 5 digits | |
Turkey | Post Code | 5 digits | |
Tuvalu | Post Code | Field Optional | |
Uganda | Post Code | Field Required | |
Ukraine | Post Code | 5 digits | |
United Arab Emirates | Post Code | Field Disabled. Sending "00000" | |
United Kingdom | Post Code | Length is 5 to 8 characters. Format begins with 1-2 uppercase letters followed by 1-2 digits, optionally a single letter, a space (optional), then ends with 1 digit and 2 uppercase letters. Supports valid formats like SW1A 1AA, W1A 0AX, etc | |
United States | Post Code | 5 or 9 (XXXXX-XXXX) digits | In the format XXXXX or XXXXX-XXXX |
United States Minor Outlying Islands | Post Code | Field Optional | |
Uzbekistan | Post Code | 6 digits (XXX XXX or XXXXXX) | In the format XXXXXX or XXX XXX |
Vanuatu | Post Code | Field Optional | |
Venezuela | Post Code | 4 digits | |
Yemen | Post Code | Field Optional | |
Zimbabwe | Post Code | Field Optional |