Country List

Control which countries are available for customer selection during checkout and address entry.

The Country List page lets you enable or disable individual countries for your storefront. When a country is disabled, customers cannot select it in the shipping or billing address dropdowns during checkout or in their account address book. All 242 countries are enabled by default. Disabling a country adds it to an exceptions list; re-enabling it removes the exception.

This is useful when your store only ships to certain regions or when you need to restrict orders to specific markets.

View Countries

Navigate to Settings > Checkout Settings > Country List in the admin sidebar. The page displays a paginated grid of all countries with their current status.

Grid Columns

Column	Description
Country Code	The 2-letter ISO country code (e.g., US, CA, GB).
Country	The full country name.
Action	Toggle button to enable or disable the country. Shows a checkmark icon when the country is enabled and a block icon when disabled.

Both the Country Code and Country columns are sortable. Click a column header to sort.

Search and Filter

Control	Description
Search	Filter the grid by country code or country name. Matches are case-insensitive.
Status Filter	Dropdown to narrow the list. Options: All (default), Enabled Only, or Disabled Only.

The search and status filter can be used together to quickly locate specific countries.

Enable or Disable a Country

Click the action button in a country's row to toggle its status:

If the country is currently enabled, clicking the button disables it. The icon changes from a checkmark to a block icon, and the tooltip reads "Enable" (indicating the next action).
If the country is currently disabled, clicking the button enables it. The icon changes from a block to a checkmark icon, and the tooltip reads "Disable."

Each toggle is saved immediately. The change is logged in the Activity Log with the action description (e.g., "enabled country US" or "disabled country CA").

Associations

Print Store

Area	Effect
Checkout address dropdowns	The single-page checkout loads only enabled countries into the shipping and billing address country dropdowns. Disabled countries are excluded via `CountryHelper.UsableCountries()`, which filters out all `CountryException` records for the store.
Address book (`AddressView`)	The customer-facing address management control also filters its country dropdown using the same exceptions list, so disabled countries cannot be selected when adding or editing saved addresses.
Default country	The checkout pre-selects a default country based on the store's `shipFromCountry` setting (or the application-level `DefaultAddressCountry` config). This default is independent of the country list but should be an enabled country.
State/Province selection	When a customer selects the United States or Canada, the address form shows a state/province dropdown (US states + DC + PR, or Canadian provinces/territories). All other countries display a free-text state field.
Store Clone	When cloning a store, all `CountryException` records are copied to the new store, preserving the same country restrictions.

Checkout Fields — custom fields shown alongside the address form at checkout
Checkout Styles — style the checkout page where country dropdowns appear
Checkout Settings — overview of all checkout configuration options