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 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” |
| 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 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: 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. John..Doe@example.com 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.  | |
| 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” |
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.
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.Examples of Allowed Inputs
The following table shows examples of allowed inputs:
The following figure shows the error message that occurs when you leave a mandatory field blank or enter an invalid number.
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.
- Easy country search by name or code.
-
Restricts input to digits only for cleaner validation.
