Customer address fields

Customer address settings decide how customers enter their shipping address at checkout: with Google Maps, with the Saudi national address, and with which address fields in each country. To open them, go to Settings > General > Checkout page options and select Customization under Customer address determination. The page opens as Customize customer address.

Customer address determination on the checkout page options, with its Customization button — Sample data from a demo store.

Set how customers locate their address

The Location determination card has two options:

Option	What it does
Select on Google Maps	Customers can search for their address and pin it on Google Maps.
Make it required	Shown under the Google Maps option. Customers must pin their location on the map. Turning off Google Maps also clears this option.
Activate national address (SPL)	Asks customers for their Saudi national address.

The Location determination card with Google Maps, Make it required and the national address option — Sample data from a demo store.

Turn the options on or off.
Select Save at the top of the page.

With Google Maps on, customers adding a new address at checkout search for it on the map, by their full address or their short national address, then complete the country, city and street fields.

The storefront's Add new address step with a Google Maps search box and the country, city, street and district fields — Personal details are covered.

The national address is now required for all domestic shipments in Saudi Arabia. Turn on Activate national address (SPL) to avoid shipment delays. The requirement covers delivery addresses in Saudi Arabia only, including orders you ship to Saudi Arabia from another country.

Prepare for the national address requirement

Under Saudi Council of Ministers Decision No. 252, which makes the national address mandatory, shipments within Saudi Arabia need the recipient's short national address, and shipping companies can delay or reject a shipment without it. To get your store ready:

Add the Short National Address of each inventory location in Saudi Arabia. See Warehouses and inventory locations.
Turn on Activate national address (SPL) under Location determination, then select Save.

Once it is on, customers who ship to Saudi Arabia give their short national address at checkout, by pinning their location on the map or by typing their address. A saved address without a short national address doesn't let them complete the payment until they add one. Customers can update their saved addresses at any time from their account in your store.

For an order placed without a short national address, such as one placed before you turned the option on, the order page shows Short address not found. Add the short address to the customer's address, then issue the shipping label. See Short address alert.

Address fields by country

The Customize the address according to the country table lists one customization per country. Each customization sets which address fields customers see at checkout when they ship to that country, and which of them are required.

Column	What it shows
Country	The country the customization applies to. Rest of the world covers every country without its own customization.
Status	Activate when the customization is in use, Deactivated when it is turned off.

The Customize the address according to the country table with Saudi Arabia, Kuwait and Rest of the world, and the Create new customization button — Sample data from a demo store.

Each row has these actions:

Action	What it does
Customization	Opens the country's fields to edit them.
Delete	Deletes the country's customization.
Activate or Deactivate	Turns the customization on or off. Shown in the row's menu.

The Rest of the world row cannot be deleted or deactivated, and the rows for Saudi Arabia, Kuwait, Oman and Qatar cannot be deleted.

Customizing address fields depends on your plan. When your plan does not include it, Create new customization, Customization and the activation button open an upgrade dialog instead.

Add address fields for a country

Select Create new customization at the top of the table.
Choose the Country.
For each address field, turn its switch on to show it at checkout or off to hide it.
Optionally, type the field name customers see, in Arabic and English.
Select Make mandatory under a field to make customers fill it in.
Select Save.

The new customization is added as active, and you return to the address settings.

Field	Shown by default	Required by default	Notes
District	Yes	Yes	Make mandatory is available only while the field is shown.
Street	Yes	No
Building Number	Yes	No
Additional number	Yes	No
Zip code	No	No
Recipient's National ID	No	No	Asks for the recipient's national ID on shipping addresses. Make it mandatory to require it before the order is placed.

Edit a country's address fields

Select Customization in the country's row.
On Edit customization, change the fields as above. The country cannot be changed.
Select Save.

Last updated 28 October 2026

Did this article solve your problem?

Your answer helps us see what needs improving.

Still need help?

Our customer service team is ready to help, or find quick answers in the FAQ.