Shopify multi-currency
CurrencyCraft reads your Shopify setup before it touches a price. Where Shopify Payments and Markets already price and charge locally, it converts nothing, because multiplying an already localised price by a second rate gives a number that matches neither Shopify nor the shopper's card statement. Everywhere else it converts what shoppers see, and names the currency the charge will actually land in.
CurrencyCraft is preparing its public App Store listing. If you already have access, open it from Apps in your Shopify admin.
Free plan with no expiry · 30-day trial on new paid subscriptions · Two setup steps you paste yourself
Is Shopify Payments activated, and does a Market have local currencies switched on?
Shopify Markets already prices and settles in the shopper's currency. Multiplying that price by a second rate gives a number that matches neither Shopify nor the shopper's card statement, so CurrencyCraft leaves it alone and hides its own picker. Use your theme's built-in country selector for Shopify's native country context. CurrencyCraft's rates, rounding, markup and Pro conversion rules apply only in Mode B, not to Markets prices or checkout.
No Shopify Payments account means Shopify cannot charge in a local currency, so the honest version is converting the displayed price and saying so. The cart, the checkout and the order stay in your base currency, and a dismissible notice tells the shopper which currency the charge lands in. A test asserts the checkout currency never moves, and it has to pass on every build.
A denied permission, Payments active with no local-currency market, or an account that was never activated all land here. A missing scope is told apart from a genuine absence, so a permission problem is never mistaken for an answer. Until you settle it the storefront converts nothing, and your manual choice always beats a later detection run.
Every line below is something the code does today. Where a capability needs a paid plan, it says so in the same sentence.
Applying an app's own exchange rate on top of a Shopify Markets price converts an already converted number.
Detection reads your Shopify Payments account and your Markets first. Where Markets already prices locally, CurrencyCraft converts nothing and hides its picker. Use your theme's native country selector; the app does not change Markets prices or checkout currency.
One store-wide rate and one store-wide rounding is fine right up to the point where you want Japan on whole yen and nobody else touched.
Five rule types across four targeting levels, resolved deterministically: market beats country beats currency beats global, then the higher priority, then the lowest rule id. Rules are on Pro and above.
The usual way to test a currency rule is to save it, open the storefront in another tab and hope.
The simulator resolves a country, market and currency through the same engine that answers your storefront, prints the converted sample price, and names the rule that won each field. Pro and above.
A trial is not a free tier. When it ends, a small store loses the switcher it just taught its customers to use.
Free is a real plan at $0 with no expiry: up to 5 currencies with the Mode B display picker, failover rates and rounding. Paid plans raise the cap and add Mode B conversion targeting.
Country JP · currency any · market any
Providers are tried in order, each behind its own circuit breaker: repeated failures open it, it is skipped for a cooldown, then one probe decides whether to close it. If the whole chain is down, the last good rate board is served and flagged stale. If even that is unusable, the price stays in your base currency.
Zero, null and non-numeric rates are dropped at one choke point before they can reach the cache or the storefront, rather than being coerced. A rate of 0 would display a product as free, so the code refuses it and shows the base-currency figure instead.
Nearest, up, down, charm99, charm95 and charm00, applied after conversion. Decimal places come from the ISO 4217 table, so JPY renders with none and KWD with three. Charm endings mean nothing on a zero-decimal currency, so they degrade to nearest whole rather than inventing a .99.
A markup percentage per currency absorbs payment spread, or pin an exact rate and the app stops following the provider for that currency. Precedence is fixed: a targeted rate override rule beats a manual rate, which beats a markup, which beats the raw provider rate.
Prices are cloaked before first paint with their layout box kept, converted in place, then revealed together, so nothing jumps under the cursor. A MutationObserver batched on animation frames catches prices added later by a quick view, a cart drawer or infinite scroll.
The setup guide covers the currency-format wrapper and theme app embed. In display-only mode, a checkout notice tells shoppers the currency Shopify will actually charge.
Under Settings, General, Currency formatting, your price has to be wrapped in a cc-money span, in both HTML fields. Shopify has no Admin API that writes those fields, so no app can do it for you. It is a paste that takes about a minute, the setup guide gives you the exact strings, and the app then reads your live formats back from Shopify and reports each field as done or not. In Mode A the wrapper is not merely unnecessary, it would set up a double conversion, so you are never asked for it there.
The theme app extension is enabled in the theme editor under App embeds, and the switcher block is placed in a section separately. Installing the app does neither. CurrencyCraft does not request the read_themes scope, so it cannot check this for you or turn it on: the setup guide asks you to confirm it. Skipping it is the most common reason a storefront shows no change at all.
Both are Mode B setup steps. For Mode A, use your theme's native country selector. The setup guide gives you the exact strings and where they go, and the same guide lives inside the app against your live settings.
Billed through Shopify, on your Shopify invoice. Free is a plan, not a trial. Full comparison.
Free plan, no expiry. The guide gives you the exact strings for the two steps Shopify makes you paste yourself, so you know what you are in for before you install.