> 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). # Multi-Currency (WPML) Configure multi-currency pricing for Mimeeq with WPML — choose automatic conversion or fixed price lists per market, currency by currency. ## Multi-Currency & Multi-Market Pricing Guide (WPML) ## Overview 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 just 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 ### Automatic Conversion **Good for:** keeping things simple, with one consistent global price. **Makes sense when:** * You want the same product to cost "the same," just converted to local currency * Small day-to-day exchange rate movements don't matter much to your margins ### A Fixed Price List for That Market **Good for:** deliberately different pricing per market. **Makes sense when:** * A specific market needs its own price point (not just a currency conversion) * Costs differ meaningfully by region (shipping, local competition, etc.) * You're running a market-specific promotion *** ## 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: | Approach | US | UK | EU | Upkeep | | -------------------- | ------ | --------------------- | --------------------- | ------------------------------------ | | Automatic conversion | $1,000 | £769 (converted) | €926 (converted) | Change one price, everything updates | | Fixed price list | $1,000 | £850 (set on purpose) | €950 (set on purpose) | Update each market's price yourself | *** ## Setting It Up **Location:** WP Admin → Mimeeq → Extension Settings → **Currency / Price List Mapping** This is a table with one row per currency/language. For each one, you decide which approach to use: 1. Pick the WPML language/currency 2. If you want **automatic conversion** for this currency: leave the **"Use Mimeeq prices"** box unchecked. WPML will handle the conversion, and you don't need to fill in a price list. 3. If you want a **fixed price list** for this currency instead: paste in the matching **Price List Group ID** from your Mimeeq account, and tick **"Use Mimeeq prices"**. 4. Save. ![Screenshot: Currency / Price List Mapping section](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) **Example mapping:** | Language / Currency | Use Mimeeq prices? | Mimeeq Price List Group | | ------------------- | ------------------ | --------------------------- | | English / USD | Off | — (converted automatically) | | German / EUR | On | EU Pricing | | English (UK) / GBP | On | UK Premium Pricing | ![Screenshot: Currency mapping table](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) **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 [Admin Settings](/commerce-and-integrations/woocommerce/admin-settings.md)), if one is set there. *** ## 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 > **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. *** ## 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 * [Admin Settings](/commerce-and-integrations/woocommerce/admin-settings.md) * [Getting Started](/commerce-and-integrations/woocommerce/getting-started.md) --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.mimeeq.com/commerce-and-integrations/woocommerce/multi-currency-wpml.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.