> For the complete documentation index, see [llms.txt](https://help.mimeeq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.mimeeq.com/commerce-and-integrations/woocommerce/multi-currency-wpml.md).

# WooCommerce Multi-Currency (WPML)

Price each market your way with WPML. Learn when to use automatic conversion or a fixed Mimeeq price list, and how to map each currency.

If your store sells in more than one currency or language using **WPML** (with its Multi-Currency add-on), you can decide, currency by currency, how prices are worked out. There are two approaches, and you're not locked into one — you choose per currency:

1. **Let WPML convert the price automatically** — simplest option, one price, converted using an exchange rate
2. **Use a fixed Mimeeq price list for that currency** — lets you set a deliberately different price for that market, instead of a straight conversion

***

## When to use which approach

<table><thead><tr><th width="58.625">#</th><th>Approach</th><th>Good for</th><th>Makes sense when</th></tr></thead><tbody><tr><td>1</td><td><strong>Automatic conversion</strong></td><td>Keeping things simple, with one consistent global price</td><td>You want the same product to cost "the same", converted to local currency. Small day-to-day exchange rate movements don't matter much to your margins</td></tr><tr><td>2</td><td><strong>A fixed price list for that market</strong></td><td>Deliberately different pricing per market</td><td>A specific market needs its own price point (not only a currency conversion). Costs differ meaningfully by region (shipping, local competition, etc.). You're running a market-specific promotion</td></tr></tbody></table>

***

## An example

Say a desk costs $1,000 in the US. Selling it in the UK and the EU, the two approaches look like this:

<table><thead><tr><th width="45.03515625">#</th><th>Approach</th><th>US</th><th>UK</th><th>EU</th><th>Upkeep</th></tr></thead><tbody><tr><td>1</td><td>Automatic conversion</td><td>$1,000</td><td>£769 (converted)</td><td>€926 (converted)</td><td>Change one price, everything updates</td></tr><tr><td>2</td><td>Fixed price list</td><td>$1,000</td><td>£850 (set on purpose)</td><td>€950 (set on purpose)</td><td>Update each market's price yourself</td></tr></tbody></table>

***

## Setting it up

{% stepper %}
{% step %}

### Open the currency mapping table

Go to **WP Admin → Mimeeq → Extension Settings → Currency / Price List Mapping**.

This is a table with one row per currency/language.

![Currency / Price List Mapping section in Extension Settings](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FV5PLG9WMb1Ujfhxd28B3%2F06-multi-currency-01-multi-mar_gd4x5x.png?alt=media)
{% endstep %}

{% step %}

### Choose the approach for each currency

1. Pick the WPML language/currency
2. For **automatic conversion**: leave the **Use Mimeeq prices** box unchecked. WPML handles the conversion, and you don't need to fill in a price list.
3. For a **fixed price list**: paste in the matching **Price List Group ID** from your Mimeeq account, and tick **Use Mimeeq prices**.
   {% endstep %}

{% step %}

### Save

Save your changes.

**Example mapping:**

<table><thead><tr><th width="50.27734375">#</th><th>Language / Currency</th><th>Use Mimeeq prices?</th><th>Mimeeq Price List Group</th></tr></thead><tbody><tr><td>1</td><td>English / USD</td><td>Off</td><td>— (converted automatically)</td></tr><tr><td>2</td><td>German / EUR</td><td>On</td><td>EU Pricing</td></tr><tr><td>3</td><td>English (UK) / GBP</td><td>On</td><td>UK Premium Pricing</td></tr></tbody></table>

![Currency mapping table with example rows for USD, EUR and GBP](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2Fr7CQpGXAtkjwlBnNgtwF%2F06-multi-currency-02-mapping-t_ht23iy.png?alt=media)
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**No mapping for a currency at all?** The plugin falls back to the single **Price list group (Mimeeq)** field on the **Primary Settings** page (see [WooCommerce Admin Settings](/commerce-and-integrations/woocommerce/admin-settings.md)), if one is set there.
{% endhint %}

***

## How it works for customers

1. A customer visits your store and WPML detects their language/currency
2. The plugin checks whether that currency has **Use Mimeeq prices** turned on
3. **If it's on:** prices come straight from the matching Mimeeq price list
4. **If it's off:** the customer sees WPML's own converted price, same as any other product on your site
5. Either way, once the item is added to the cart, that same pricing decision carries through to checkout

{% hint style="success" %}
**Good to know:** once a product is in the cart, its price stays in sync with the currency mapping — so if a customer switches language partway through, the cart reflects the right pricing for their new currency.
{% endhint %}

***

## Troubleshooting

### Prices in the configurator don't match what shows in the cart

* Make sure the exchange rates in WPML Multi-Currency are set correctly for currencies using automatic conversion
* Double-check the Price List Group ID for currencies using a fixed price list
* Confirm the right embed template is assigned for each language

### Prices aren't updating for a particular currency

* Check that the mapping row for that currency is saved
* Confirm the price list is marked active on the Mimeeq side
* Double-check the WPML language/currency setup itself

***

## Related articles

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>WooCommerce Admin Settings</strong></td><td>Configure API, cart, product naming and sync settings.</td><td><a href="/commerce-and-integrations/woocommerce/admin-settings.md">WooCommerce Admin Settings</a></td></tr><tr><td><strong>WooCommerce Getting Started</strong></td><td>Install the plugin, add your API key and sync products.</td><td><a href="/commerce-and-integrations/woocommerce/getting-started.md">WooCommerce Getting Started</a></td></tr><tr><td><strong>WooCommerce FAQ</strong></td><td>Find answers on pricing, tax, currencies and page speed.</td><td><a href="/commerce-and-integrations/woocommerce/faq.md">WooCommerce FAQ</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.mimeeq.com/commerce-and-integrations/woocommerce/multi-currency-wpml.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.