Skip to Content

Search

Download
Account
Enter the email address on your account.
Forgot Your Username?
Enter your password.
Forgot Your Password?

Or continue with

J2Commerce 6

Countries

4 Min Read
On This Page

Countries form the foundation of localization in J2Commerce. They define the geographic options available to customers during checkout, in shipping zones, and for tax calculations. Each country includes ISO standard codes that ensure compatibility with shipping carriers, payment gateways, and address validation services.

Requirements

  • PHP 8.3.0+
  • Joomla 6.x
  • J2Commerce 6.x

Locating Countries

Countries are managed from the J2Commerce Dashboard.

There are two ways you can access the Countries.

Option A: Go to the J2Commerce icon at the top right corner -> Localization -> Countries

Option B: Go to Components on the left sidebar -> J2Commerce -> Dashboard -> Localization -> Countries

Countries list opened via Components, J2Commerce, Dashboard and the Localization menu, with the Countries item highlighted in the J2Commerce side menu

Country List

The Countries list displays all countries configured in your store. Each country shows:

Checkbox: Select countries for batch actions.

Country Name: The display name of the country. The display name is shown to customers and in admin lists. Example: United Kingdom

ISO Code 2: The 2-letter ISO 3166-1 alpha-2 country code. Must be exactly 2 characters, uppercase. Example: US, GB, DE

ISO Code 3: The 3-letter ISO 3166-1 alpha-3 country code. Must be exactly 3 characters, uppercase. Example: USA, GBR, DEU

ISO Numeric: The 3-digit ISO 3166-1 numeric country code. Optional but recommended for international integrations. Example: 840, 826, 276

Status: Set to Published to make the country available, or Unpublished to hide it.

Ordering: Drag-and-drop to reorder the display sequence.

Adding a New Country

  1. Click the New button in the toolbar.
  2. Fill in the country details (see Configuration below).
  3. Click Save or Save & Close.

Edit Country form for United Kingdom: ISO 3166-1 alpha-2 GB, alpha-3 GBR, numeric 826 and Status Published, with Save & Close highlighted

ISO Code Standards

The ISO codes follow the ISO 3166-1 international standard:

  • ISO Code 2 (alpha-2): Two-letter codes used by most systems for country identification. Examples: US (United States), CA (Canada), AU (Australia), GB (United Kingdom).
  • ISO Code 3 (alpha-3): Three-letter codes that provide more clarity. Examples: USA, CAN, AUS, GBR.
  • ISO Numeric: Three-digit codes that are language-independent. Examples: 840 (US), 124 (CA), 036 (AU), 826 (GB).

These codes ensure compatibility with:

  • Shipping carriers (FedEx, UPS, DHL)
  • Payment gateways (Stripe, PayPal)
  • Address validation services
  • Tax calculation services

Countries list with the ISO 2, ISO 3 and ISO Number columns outlined, showing codes such as AF, AFG and 4 for Afghanistan

How Countries Are Used

Countries are referenced throughout J2Commerce:

  1. Customer Addresses — Customers select their country during checkout or when managing their address book.
  2. Shipping Zones — Define which countries a shipping method applies to.
  3. Tax Geozones — Create geographic zones for tax calculations.
  4. Payment Restrictions — Restrict payment methods to specific countries.
  5. Zone Configuration — Each zone (state/province) belongs to a country.

Bulk Actions

The Actions button will be hidden until at least one country is chosen.

  • Publish — Enable selected countries
  • Unpublish — Disable selected countries
  • Trash — Move selected countries to trash

Countries list with the Actions menu open (Publish, Unpublish, Trash) and the checkboxes for Afghanistan, Albania and Algeria outlined

Search and Filter

Use the search and filter options to find countries:

  • Search — Type a country Name or ISO code to filter the list.
  • ID Search — Type id:222 to find a country by its ID.
  • Status Filter — Filter by Published, Unpublished, Trashed, or All

Countries list searched for united, with Filter Options open and the Select Status dropdown listing Trashed, Unpublished, Published and All; ID column outlined

Tips

  • Use standard ISO codes — Always use official ISO 3166-1 codes. Non-standard codes may cause integration issues with shipping and payment providers.
  • Disable unwanted countries — Unpublish countries you do not ship to rather than deleting them. This preserves data integrity if zones are linked to those countries.
  • Order matters — Reorder countries to show your primary markets first in dropdown lists.
  • Keep ISO codes uppercase — The system automatically converts codes to uppercase, but always enter them in uppercase for consistency.
  • Complete all ISO codes — Filling in all three ISO code formats ensures maximum compatibility with third-party integrations.

Troubleshooting

Country Not Appearing in Dropdown

Cause: The country is unpublished or has invalid ISO codes.

Solution:

  1. Go to J2Commerce -> Localization -> Countries.
  2. Search for the country by name or ISO code.
  3. Check that the Status shows a green checkmark (Published).
  4. Verify the ISO Code 2 and ISO Code 3 fields contain valid 2 and 3 character codes, respectively.

Countries list with the Status check, ISO 2 code AF and ISO 3 code AFG outlined on the Afghanistan row

ISO Code Validation Error

Cause: ISO codes must be exactly 2 or 3 characters and contain only letters.

Solution:

  1. Edit the country.
  2. For ISO Code 2, enter exactly 2 uppercase letters (e.g., US, GB, FR).
  3. For ISO Code 3, enter exactly 3 uppercase letters (e.g., USA, GBR, FRA).
  4. Save the country.

Zones Not Loading for a Country

Cause: No zones are configured for the country, or all zones are unpublished.

Solution:

  1. Go to J2Commerce -> Localization -> Zones
  2. Filter by the country using the Country dropdown.
  3. Verify zones exist and are published.
  4. If no zones exist, create zones for the country.

Zones list reached through the J2Commerce Localization menu, with Localization and Zones highlighted and a published zone's Status outlined

Country Already Exists Error

Cause: A country with the same ISO code already exists in the system.

Solution:

  1. Search for the existing country using the ISO code.
  2. Either edit the existing country to modify it, or unpublish duplicate entries if created in error.
  3. Each ISO code must be unique in the system.

Still stuck? Our team can help.

Download Get Support