How do I change a market's currency and exchange rate?

How currencies work in Storeep

Each market has exactly one currency. Buyers in that market see all product prices, shipping costs, and order totals in that currency. The currencies you can choose for a market depend on its country: you can only pick from the currencies recognised for that country.

Your primary market's currency is the store base currency. Every product price is stored once in that base currency, and each other market's prices are derived from it using live exchange rates. So when you change a non-primary market's currency, that market's prices are recalculated from the base prices at the new rate, not carried over as the same numbers from the old currency.

Changing the currency for a market

1. Go to Settings, Markets.
2. Click the market you want to edit.
3. Click Currency and symbol.
4. Search and pick a currency from the Currencies list.
5. Pick a Currency symbol from the list that loads for that currency.
6. To override the automatic rate, click Manual conversion and type a value in the Rate field (optional, see below).
7. Click Save.

The currency symbol

After choosing a currency you must also choose a Currency symbol. The symbol is shown after the price in your storefront, so the same amount can read as 100 MAD or 100 د.م. depending on which symbol you pick. Each currency offers only the symbols that are standard for it (the list loads automatically once you select the currency).

Some symbols come in a singular and plural form joined by a slash, for example Dirham/Dirhams. If you pick one of those, the storefront shows the singular or plural wording automatically based on the amount.

Automatic price conversion

When you change a market's currency (or save with a manual rate), Storeep rebuilds that market's prices from the store base price using the new exchange rate. How each product is treated depends on whether you had customised its price for that market:

• Prices left at the default (still tracking the converted base price) are recalculated to the new currency automatically.
• Prices you manually customised for that market keep their existing number and are not reconverted. The raw figure stays the same even though the currency changed, so revisit any manually priced products after a currency switch and adjust them.

The same rule applies to discounted prices: a default discounted price is reconverted, a manually set one is left as is.

Changing the primary market's currency

Because the primary market's currency is the store base currency, changing it also re-denominates the stored base prices themselves so every future conversion uses the new currency as the reference. For example, if base prices were in MAD and you switch the primary market to USD at a rate near 0.10, a 100 MAD base becomes roughly 10 USD. After saving, spot-check a few products to confirm the converted figures look right.

Manual rate override

The rate controls only appear when you pick a currency different from the market's current one. A note shows the current live rate as 1 [old currency] = [rate] [new currency]. Click Manual conversion to reveal the Rate field, which is pre-filled as a placeholder with that live rate. Leave it blank to use the live rate, or type your own value to override it.

A custom rate must stay within 0.05 (an absolute amount, added or subtracted) of the live market rate. If you enter a value more than 0.05 above or below it, Storeep blocks the save and shows "The conversion rate you entered is much higher than the market rate" or "much lower than the market rate". This guard stops a mistyped rate from multiplying or dividing all your prices by an unexpected amount. A rate that is not a valid number (digits, with up to 14 decimal places) is rejected with "The conversion rate you entered is incorrect".

After saving, you can still fine-tune individual product prices for that market at any time from the market's Products section.

What to check

• If prices look wrong after a currency change, confirm whether you left the Rate field blank (live rate) or entered a custom rate, and that the custom value was correct.
• If your custom rate is rejected, compare it to the live rate shown in the note: the allowed window is 0.05 above and below that rate.
• Manually customised market prices are not reconverted, so always re-check those products after switching a currency.
• Changing the primary market's currency rewrites the base prices for your whole store, so spot-check several products afterwards.