> 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/shopify/multi-currency-and-markets.md).

# Shopify Multi-Currency & Markets

Show customers accurate prices in every Shopify market. Learn to set up exchange-rate pricing or multi-market price list mappings for your configurator.

Configure Mimeeq's 3D configurator with Shopify Markets to display region-specific pricing. Mimeeq supports two types of multi-market pricing:

* **Exchange Rate Method**: currency conversion using fixed exchange rates
* **Multi-Market Mappings**: fixed price list-based pricing for each market

***

## Choose your pricing method

<table><thead><tr><th width="49.26171875">#</th><th width="142.79296875">Method</th><th>How it works</th><th>Best for</th><th>Use when</th></tr></thead><tbody><tr><td>1</td><td><strong>Exchange Rate Method</strong></td><td>Maintains a single pricing strategy across all markets, converting your base currency prices using fixed exchange rates.</td><td>Simple currency conversion with consistent global pricing</td><td>Your product pricing is consistent globally; price differences are purely currency-based; exchange rate fluctuations don't significantly impact margins</td></tr><tr><td>2</td><td><strong>Multi-Market Mappings Method</strong></td><td>Connects each Shopify market catalogue to a specific Mimeeq Price List Group, giving you complete control over regional pricing.</td><td>Region-specific pricing strategies</td><td>Different markets require different price points; you have region-specific cost structures; you run market-specific promotions</td></tr></tbody></table>

### Comparison example

**Scenario:** selling a $1,000 USD desk to US, UK and EU markets.

<table><thead><tr><th width="73.96875">#</th><th>Method</th><th>US market</th><th>UK market</th><th>EU market</th><th>Management</th></tr></thead><tbody><tr><td>1</td><td><strong>Exchange Rate</strong></td><td>$1,000</td><td>£769 (converted)</td><td>€926 (converted)</td><td>Update one price</td></tr><tr><td>2</td><td><strong>Multi-Market</strong></td><td>$1,000</td><td>£850 (set manually)</td><td>€950 (set manually)</td><td>Update three prices</td></tr></tbody></table>

With the Exchange Rate Method, the UK price is purely conversion-based. With Multi-Market Mappings, you can set £850 to account for higher UK shipping costs or market positioning.

***

## Set up the exchange rate method

When using Mimeeq with Shopify Markets, keep these key concepts in mind:

* Each Shopify store has a base currency (e.g. USD).
* Shopify Markets lets you create different markets with different currencies.
* Mimeeq templates can be assigned to specific markets.
* When a product is added to cart, it must use the base currency pricing, with Shopify handling the conversion.

{% stepper %}
{% step %}

### Create price lists in Mimeeq

Create separate price structures for each currency:

1. Create price lists for each currency:
   * US dollar price list
   * British pound price list
   * Euro price list
2. Create public price list groups for each currency:
   * USD public price list group
   * GBP public price list group
   * EUR public price list group
3. Create embed templates for each currency:
   * Template "Shopify public USD" → USD public price list group
   * Template "Shopify public GBP" → GBP public price list group
   * Template "Shopify public EUR" → EUR public price list group
     {% endstep %}

{% step %}

### Configure the Shopify theme for the default market

1. Navigate to your Shopify theme customisation.
2. Add your default template to the configurator embed.
3. Enter your default template name (e.g. "Shopify public USD").
4. Save the settings.
   {% endstep %}

{% step %}

### Configure market-specific templates

1. Use the market dropdown at the top of the Shopify theme screen to switch markets.
2. Override the template for each market:
   * UK market → "Shopify public GBP" template
   * EU market → "Shopify public EUR" template
3. Save for each market.
   {% endstep %}

{% step %}

### Configure price calculation for the cart

Shopify requires all cart additions in the base currency.

1. Go to the Mimeeq app in your Shopify admin.
2. Under **Primary Settings**, find **Override Price Group**.
3. Copy the ID from your base currency price list group (USD).
4. Paste it into the **Override Price Group** field.
5. Save the settings.
   {% endstep %}

{% step %}

### Align exchange rates

Keep pricing consistent between the configurator and checkout.

1. In Shopify Markets settings, configure fixed exchange rates (not dynamic).
2. In Mimeeq, navigate to **Settings → Pricing → Exchange Rates**.
3. Enter the same exchange rates you configured in Shopify.
   {% endstep %}
   {% endstepper %}

This diagram shows how the data is connected and flows:

![Diagram of how Shopify markets, Mimeeq embed templates, price list groups and exchange rates connect](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FT1BNt0QHAX07OYXjcY1W%2Fshopify-markets-mimeeq-flow-di_1q2k29i.jpg?alt=media)

***

## Set up multi-market mappings

{% stepper %}
{% step %}

### Access multi-market mappings

Open the Mimeeq app in your Shopify admin panel and navigate to **Extension Settings > Multi-Market Pricing**.
{% endstep %}

{% step %}

### Map catalogues to price lists

For each market you want to configure:

1. Select the Shopify catalogue from the dropdown.
2. Copy the corresponding **Public Price List Group** ID from the Mimeeq app and paste it in.
3. Click **Save Mapping**.
   {% endstep %}

{% step %}

### Verify your mappings

Review the mapping table to confirm all markets are correctly configured:

| Shopify catalogue | Mimeeq Price List Group |
| ----------------- | ----------------------- |
| US Market         | US Strategic Pricing    |
| EU Market         | EU Pricing              |
| UK Market         | UK Premium Pricing      |
| {% endstep %}     |                         |
| {% endstepper %}  |                         |

{% hint style="info" %}
When using Multi-Market Mappings with dynamic product generation, consider implementing Cart/Admin Bundles to automatically generate the correct product variants when adding to cart. Learn more in [Shopify Add to Cart Methods](/commerce-and-integrations/shopify/add-to-cart.md).
{% endhint %}

***

## How it works for customers

{% tabs %}
{% tab title="Exchange Rate Method" %}

1. Customer visits from the UK.
2. Shopify detects the location and shows the UK market.
3. The Mimeeq configurator loads the "Shopify public GBP" template.
4. Prices are displayed in GBP based on exchange rates.
5. Add to cart converts to USD (base currency).
6. Shopify converts USD back to GBP for display.
7. Customer sees consistent GBP pricing throughout.
   {% endtab %}

{% tab title="Multi-Market Mappings" %}

1. Customer visits from the UK.
2. Shopify detects the location and shows the UK market.
3. The system loads the UK catalogue mapped to the "UK Premium Pricing" group.
4. Prices are displayed directly from the UK Price List Group.
5. Add to cart uses UK-specific pricing.
6. Customer sees UK market pricing throughout checkout.
   {% endtab %}
   {% endtabs %}

{% hint style="warning" %}
**Important:** when a product is added to cart, Mimeeq automatically synchronises prices across all mapped catalogues. If a customer adds a product in the UK market and then switches to the EU market, Shopify displays the correct EU catalogue price, because all catalogues were updated during the add-to-cart operation.
{% endhint %}

***

## Troubleshooting

### Exchange rate method: price discrepancies between configurator and cart?

* Verify exchange rates match between Mimeeq and Shopify.
* Confirm the correct **Override Price Group** ID is set.
* Ensure templates are correctly assigned to markets.
* Check that Shopify uses fixed (not dynamic) rates.

### Multi-market mappings: prices not updating for different markets?

* Verify catalogue mappings are saved correctly.
* Confirm price lists are set to **Active**.
* Check that Shopify Markets catalogues are properly configured.

***

## 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>Shopify Add to Cart Methods</strong></td><td>Choose how configured products and bundles reach the cart.</td><td><a href="/commerce-and-integrations/shopify/add-to-cart.md">Shopify Add to Cart Methods</a></td></tr><tr><td><strong>Shopify Admin Settings</strong></td><td>Connect your API key, products and cart settings.</td><td><a href="/commerce-and-integrations/shopify/admin-settings.md">Shopify Admin Settings</a></td></tr><tr><td><strong>Shopify Theme Extension</strong></td><td>Add configurators and buttons to your storefront theme.</td><td><a href="/commerce-and-integrations/shopify/theme-extension.md">Shopify Theme Extension</a></td></tr><tr><td><strong>Shopify Discount Codes</strong></td><td>Apply discount codes to configured products and bundles.</td><td><a href="/commerce-and-integrations/shopify/discount-codes.md">Shopify Discount Codes</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/shopify/multi-currency-and-markets.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.