githubEdit

Local

Configuring store localization, languages, and currencies in OpenCart 4

Introduction

The Local tab is responsible for adapting your store to a specific region and language. These settings affect how customers see your storefront, which currency is used for transactions, and what units of measurement are applied to your products.

Accessing Local Settings

1

Log in to your admin dashboard and go to System → Settings.

2

Edit Store

Find your store in the list (usually "Your Store" by default) and click the Edit (blue pencil) button on the right.

3

Select Local Tab

In the store configuration interface, click the Local tab.

Configuration Fields

Below are the key fields found in the Local tab:

Geography & Language

  • Country: Select the primary country where your store is located.

  • Region / State: Select the specific region or state.

  • Language: Select the default language for the storefront (Catalog).

  • Administration Language: Select the language used in the admin dashboard.

Currency & Auto-Updates

  • Currency: Select the default currency used for product prices.

  • Auto Update Currency: Set this to Yes to allow OpenCart to automatically fetch and update currency exchange rates daily.

Units of Measurement

  • Length Class: The default unit for product dimensions (e.g., Centimeter, Inch).

  • Weight Class: The default unit for product weight (e.g., Kilogram, Pound).

circle-info

Note: To add more languages or currencies beyond the defaults, you must first configure them under System → Localization. Once added there, they will appear as options in this Local tab.

Common Tasks

Adding a New Language to the Storefront

If you want to offer your store in multiple languages:

  1. Go to System → Localization → Languages and add the new language first.

  2. Navigate back to System → Settings → Local.

  3. Select the new language from the Language dropdown.

  4. Click Save.

Enabling Automatic Currency Updates

To ensure your prices stay accurate for international customers:

  1. Navigate to the Currency & Auto-Updates section.

  2. Set Auto Update Currency to Yes.

  3. Ensure your default currency (set in the Currency dropdown) is the base currency you want others to calculate from.

Best Practices

chevron-rightCurrency Managementhashtag

Dynamic Exchange Rates

  • Default Currency: Always set your default currency to the one you use for bookkeeping and pricing your products in the backend.

  • Auto-Update: Enabling auto-update is recommended if you accept multiple currencies to ensure your prices remain competitive and accurate against the market.

chevron-rightLocalization for User Experiencehashtag

Tailored Shopping

  • Region Accuracy: Ensure your country and region are accurate, as these are often used as the starting point for shipping and tax calculations.

  • Unit Consistency: Choose units that are standard for your primary target market to avoid confusing your customers (e.g., use Kilograms for Europe and Pounds for the USA).

circle-check

Troubleshooting

chevron-rightCurrency Rates are not updatinghashtag

Localization and Server Issues

  • Check Localization Settings: Ensure the currencies you want to update are correctly set up in System → Localization → Currencies.

  • Server Connectivity: Your server must be able to connect to external currency API services. Check with your host if outgoing connections are restricted.

  • Manual Update: You can manually update rates by clicking the "Refresh" button in the Currencies list.

chevron-rightMeasurements are appearing incorrectly on productshashtag

Default Class and Product Data

  • Default Class: Verify that the correct Length Class and Weight Class are selected in the Local tab.

  • Product Data: Individual products must have their own weight and dimensions defined in their "Data" tab. Ensure they are using the same units set as default here.

"Localization is about more than just translation; it's about making your customer feel at home. Correct regional settings are the foundation of global commerce."

Last updated