> 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/pricing-and-codes/pricing-setup/pricing-overview.md).

# Pricing Overview

Control how prices are calculated for every market and customer. Learn to set up currencies, markets, market cost prices, price lists, quantity breaks and public price groups.

This guide walks you through the components of the Mimeeq pricing system. The system may seem complex at first, but it is designed for ease and efficiency once you are familiar with it. For practical applications, see the example scenarios at the end of this article.

```mermaid
flowchart LR
  A[Currencies and exchange rates] --> B[Markets] --> C[Market cost prices] --> D[Price lists] --> E[Final prices]
```

***

## Settings

Access the pricing settings through the admin panel. Go to **Settings** and select **Pricing Settings** on the left side of the screen.

***

## Currencies and exchange rates

Start by adding the currencies you sell in:

1. Click **Add Currency**.
2. Enter a friendly name and select the international currency code.
3. Choose whether this will be your default currency.
4. Set an exchange rate.

**Example currencies:**

* **EUR (default):** exchange rate 1
* **USD:** exchange rate 1.2
* **GBP:** exchange rate 0.9

***

## Markets

Markets represent the regions you sell to. You can define any number of markets. They are not tied to specific countries, but they define your cost prices.

This guide uses two markets: **EUROPE** (EUR) and **USA** (USD).

{% hint style="info" %}
There is no separate market for the UK in this example. The UK uses the EUROPE market, and the GBP exchange rate is applied later in the price list.
{% endhint %}

***

## Market cost prices (MCP)

Import your cost and recommended retail price (RRP) for each product code and market.

{% hint style="info" %}
To learn how to import prices, see [CSV Import Templates - Pricing and Item Master](/pricing-and-codes/pricing-setup/csv-templates.md).
{% endhint %}

**Example:**

* **Market:** EUROPE, **Code:** CHAIR-MODEL1-FABRIC, **Qty:** 1, **Cost:** €150, **RRP:** €250
* **Market:** USA, **Code:** CHAIR-MODEL1-FABRIC, **Qty:** 1, **Cost:** $167, **RRP:** $275

***

## Price lists

Price lists transform market cost prices (MCP) into final prices. Every price list has a **General** tab for its settings and a **Companies** tab where you assign the companies that use it.

The most common price list type is the **Calculated Price List**.

<table><thead><tr><th width="50.71875">#</th><th>Price list type</th><th width="102.25">Costs come from</th><th>RRP and sale prices come from</th><th>Use it for</th></tr></thead><tbody><tr><td>1</td><td><strong>Calculated Price List</strong></td><td>MCP</td><td>MCP, with optional manipulation, rounding and sale discount</td><td>Most price lists</td></tr><tr><td>2</td><td><strong>Fixed Price List</strong></td><td>MCP</td><td>Prices you add or import in the <strong>Prices</strong> tab</td><td>Controlling exact RRP and sale prices, especially for quantity breaks that differ from your MCP</td></tr><tr><td>3</td><td><strong>Linked Price List</strong></td><td>MCP</td><td>The fixed price list it is linked to, with additional manipulation</td><td>Adjusting prices for different client segments or currencies</td></tr></tbody></table>

{% tabs %}
{% tab title="Calculated price list" %}
In the **General** tab of a Calculated Price List, you can set:

<table><thead><tr><th width="194.84375">Field</th><th>Description</th></tr></thead><tbody><tr><td><strong>Name</strong></td><td>The name used to organise your price list.</td></tr><tr><td><strong>Status</strong></td><td>Whether the price list is active or inactive.</td></tr><tr><td><strong>Valid Period</strong></td><td>The date range in which this price list is valid.</td></tr><tr><td><strong>Market</strong></td><td>The market from which to pull the costs and RRP.</td></tr><tr><td><strong>Currency</strong></td><td>The currency for sales in this price list. Uses the exchange rates from settings if it differs from the market's currency.</td></tr><tr><td><strong>Scope</strong></td><td>The extent of the price list's coverage, such as a specific product or product group.</td></tr><tr><td><strong>Cost Manipulation</strong></td><td>A factor to adjust the market cost price (MCP), where 1 is the default. For a 10% increase, enter 1.1.</td></tr><tr><td><strong>RRP Manipulation</strong></td><td>Adjusts the base RRP from the MCP, like the cost manipulation above. For RRP, it also includes rounding to the nearest 1, 2, 5, etc., with a default of 0.01. Rounding can be set to round, round up or round down, using the logic of Excel's ROUND, CEILING and FLOOR functions respectively.</td></tr><tr><td><strong>Sale Price</strong></td><td>Shows the sale price as a discount from the RRP. The discount percentage is applied after any RRP manipulation, including rounding. You can round sale prices using the same logic as for RRP.</td></tr></tbody></table>

**Example price lists:**

1. **United States:** market USA, currency USD.
2. **Europe (Excluding UK):** market EUROPE, currency EUR.
3. **United Kingdom (UK):** market EUROPE, currency GBP (with RRP rounded to the nearest 2).
   {% endtab %}

{% tab title="Fixed price list" %}
Use a Fixed Price List to control exact RRP and sale prices, especially for quantity breaks that differ from your MCP.

| Field                 | Description                                                                                                                |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Name**              | The name used to organise your price list.                                                                                 |
| **Status**            | Whether the price list is active or inactive.                                                                              |
| **Valid Period**      | The date range in which this price list is valid.                                                                          |
| **Market**            | The market from which to pull the costs and RRP.                                                                           |
| **Currency**          | The currency for sales in this price list. Uses the exchange rates from settings if it differs from the market's currency. |
| **Prices** tab        | Where you add, or more likely import, your fixed prices.                                                                   |
| **Cost Manipulation** | A factor to adjust the market cost price (MCP), where 1 is the default. For a 10% increase, enter 1.1.                     |
| {% endtab %}          |                                                                                                                            |

{% tab title="Linked price list" %}
A Linked Price List connects to a fixed price list and applies additional manipulations. It takes the costs from the MCP, but the RRP and sale prices from the fixed price list it is linked to.

| Field                 | Description                                                                                                                                                                                                                                                                        |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**              | The name used to organise your price list.                                                                                                                                                                                                                                         |
| **Status**            | Whether the price list is active or inactive.                                                                                                                                                                                                                                      |
| **Valid Period**      | The date range in which this price list is valid.                                                                                                                                                                                                                                  |
| **Market**            | The market from which to pull the costs and RRP.                                                                                                                                                                                                                                   |
| **Currency**          | The currency for sales in this price list. Uses the exchange rates from settings if it differs from the market's currency.                                                                                                                                                         |
| **Cost Manipulation** | A factor to adjust the market cost price (MCP), where 1 is the default. For a 10% increase, enter 1.1.                                                                                                                                                                             |
| **RRP Manipulation**  | Adjusts the base RRP, like the cost manipulation above. For RRP, it also includes rounding to the nearest 1, 2, 5, etc., with a default of 0.01. Rounding can be set to round, round up or round down, using the logic of Excel's ROUND, CEILING and FLOOR functions respectively. |
| **Sale Price**        | Shows the sale price as a discount from the RRP. The discount percentage is applied after any RRP manipulation, including rounding. You can round sale prices using the same logic as for RRP.                                                                                     |
| {% endtab %}          |                                                                                                                                                                                                                                                                                    |
| {% endtabs %}         |                                                                                                                                                                                                                                                                                    |

***

## Quantity breaks

Quantity breaks apply discounts based on the volume of the purchase. Mimeeq uses a threshold model: the price per unit drops once the quantity reaches each threshold.

<table><thead><tr><th width="68.9921875">#</th><th>Quantity ordered</th><th>Price per unit (€)</th></tr></thead><tbody><tr><td>1</td><td>1–4</td><td>10</td></tr><tr><td>2</td><td>5–9</td><td>9</td></tr><tr><td>3</td><td>10+</td><td>8</td></tr></tbody></table>

**How the calculation works:**

* If a customer orders between 1 and 4 units, each unit is priced at €10.
* When the quantity reaches 5 to 9 units, the price per unit drops to €9.
* For orders of 10 units or more, the unit price drops to €8.

**Practical examples:**

* **Order of 6 units:** the order is above 5 units but below 10, so the price is €9 per unit. The total is 6 × €9 = €54.
* **Order of 10 units:** the order meets the 10-unit threshold, so the price is €8 per unit. The total is 10 × €8 = €80.

{% hint style="warning" %}
**Current limitation:** Mimeeq does not support graduated quantity breaks at this time. Graduated breaks apply a different rate at each threshold, rather than one flat rate for all units beyond a threshold. We are open to exploring this based on customer feedback. Contact us if you need graduated quantity breaks or other custom pricing structures.
{% endhint %}

***

## Item Master

Item Master is not directly related to pricing, but it can supply additional data such as delivery information, weights and dimensions. See [Item Master](/pricing-and-codes/pricing-setup/item-master.md) for more information.

***

## Public price groups

Public price groups manage public prices in the configurator for platforms like Shopify. Create a separate price group for each market (USA, UK, EU, etc.).

1. Go to **Settings**.
2. Find **Pricing** in the left-hand menu and scroll down to **Public Price Groups**.
3. Create a public price group and give it a friendly name.
4. Fill in the fields as described in the table below.
5. Click **Save**.

You can assign price list groups to embed templates, or change them dynamically using the front-end embed API.

<table><thead><tr><th width="191.52734375">Field</th><th>Description</th></tr></thead><tbody><tr><td><strong>Name</strong></td><td>The name of the price list, used for identification and organisation.</td></tr><tr><td><strong>Slug</strong></td><td>Auto-generated as a random string of characters, so it cannot be easily guessed. You can rename it if you like.</td></tr><tr><td><strong>Price List Currency</strong></td><td>The currency in which the prices in this list are displayed and calculated.</td></tr><tr><td><strong>Price Type</strong></td><td>The price list field to show: cost, sale or RRP.</td></tr><tr><td><strong>Including VAT</strong></td><td>Whether the prices exclude or include VAT (sales tax).</td></tr></tbody></table>

***

## Utilising price lists in quotations

Quotations follow a specific workflow. Each contact is associated with a company, and a price list is linked to that company. If a contact has no company, create one under a general name such as "Cash Sales" or "Unaffiliated" for quoting.

The quotation system uses these price fields to set the pricing for each product:

<table><thead><tr><th width="60.296875">#</th><th>Price type</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td><strong>RRP</strong></td><td>The standard list price assigned to the product.</td></tr><tr><td>2</td><td><strong>Sale</strong></td><td>The usual price that the company pays for the product.</td></tr><tr><td>3</td><td><strong>Cost</strong></td><td>The base cost price for the product.</td></tr></tbody></table>

{% hint style="info" %}
For a full guide to creating and managing quotations, see our dedicated help articles on quotations.
{% endhint %}

***

## Example scenarios

### Example 1: multi-region furniture retailer

**Scenario:** a furniture retailer operates in Europe and the USA. It wants a simple pricing structure that uses a single market for both regions.

**Solution:**

* Define the `EUROPE (EUR)` market in Mimeeq.
* Set up a Calculated Price List for the EUROPE market with the default exchange rate (EUR).
* Apply the exchange rate to convert EUR prices to USD for sales in the USA, using an exchange rate of `1.2` to `USD`.

**Calculation example:**

* The retailer sets the cost price for a chair model in the EUROPE market at €150 and the RRP at €250.
* For sales in the USA, these EUROPE market prices are converted using the exchange rate of 1.2.
* The cost in the USA becomes $180 (€150 × 1.2) and the RRP becomes $300 (€250 × 1.2).

**Price calculation breakdown for the USA:**

* **EUROPE market cost:** `€150`
* **EUROPE market RRP:** `€250`
* **Exchange rate to USD:** `1.2`
* **USA cost (after exchange rate):** `€150 × 1.2 = $180`
* **USA RRP (after exchange rate):** `€250 × 1.2 = $300`

### Example 2: seasonal discounts for electronics

**Scenario:** an electronics distributor wants to offer seasonal discounts to move inventory during the holiday season.

**Solution:**

* Create a new Calculated Price List named "Holiday Specials".
* Set the list to be active for the valid period from November to January.
* Apply a sale price discount of `20%` across the board and round RRP prices to the nearest `0.99` to appeal to psychological pricing.

**Calculation example:**

* An electronic item with an RRP of €499 is discounted by 20% during the holiday season.
* The sale price is calculated after the discount, then rounded up to the nearest €0.99 for psychological pricing.

**Price calculation breakdown for the seasonal discount:**

* **Original RRP:** `€499`
* **Discount (20%):** `0.20 × €499 = €99.8`
* **Sale price before rounding:** `€499 - €99.8 = €399.2`
* **Sale price after rounding:** `€399.99`

### Example 3: B2B discounts for bulk orders

**Scenario:** a B2B office supplies company wants to encourage bulk purchases by offering quantity breaks.

**Solution:**

* Set up a new price list with quantity breaks in Mimeeq.
* Offer a unit price of `€10` for 1–49 units, `€9` for 50–99 units and `€8` for 100 or more units.
* Communicate this tiered pricing to clients to encourage larger orders.

**Calculation example:**

* The company offers €10 per unit for 1–49 units, €9 per unit for 50–99 units and €8 per unit for 100+ units.
* A client orders 75 units, which falls into the second quantity break. The total is calculated at €9 per unit.

**Price calculation breakdown for the bulk order:**

* **Quantity ordered:** `75 units`
* **Unit price for 50–99 units:** `€9`
* **Total without quantity break:** `75 × €10 = €750`
* **Total with quantity break:** `75 × €9 = €675`
* **Total saving:** `€750 - €675 = €75`

***

## FAQ

**What happens if I assign more than one price list to a customer?**

Mimeeq uses the cheapest price list.

***

## 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>CSV Templates</strong></td><td>Download templates to import Item Master data and market cost prices.</td><td><a href="/pricing-and-codes/pricing-setup/csv-templates.md">CSV Templates</a></td></tr><tr><td><strong>Item Master</strong></td><td>Store delivery times, weights and dimensions for each item code.</td><td><a href="/pricing-and-codes/pricing-setup/item-master.md">Item Master</a></td></tr><tr><td><strong>Shopify Admin Settings</strong></td><td>Connect your API key, products and cart settings, including multi-market pricing.</td><td><a href="/commerce-and-integrations/shopify/admin-settings.md">Shopify Admin Settings</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/pricing-and-codes/pricing-setup/pricing-overview.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.