FAQ
Including the awkward ones. Everything below describes what the app does today, not what it might do later.
No. CurrencyCraft never touches the cart, the checkout or the order total.
The app runs in one of two modes and picks the right one for your store automatically. In Mode A, where you have Shopify Payments and a Market with local currencies, Shopify Markets already prices and settles in the local currency. CurrencyCraft does no conversion at all in that mode, because multiplying an already-localised price by a second rate would double convert. CurrencyCraft hides its own picker in Mode A. Use your theme's native country selector for Shopify's country context. The app does not change Markets prices or checkout currency.
In Mode B, where the store has no Shopify Payments, CurrencyCraft converts the displayed price so a shopper can read it in their own currency. Checkout still settles in your store's base currency, and the storefront shows a dismissible notice saying so. The seeded wording is You will be charged in {base} at checkout, and the storefront substitutes your store currency code, so a store based in US dollars shows "You will be charged in USD at checkout". You can rewrite it, you cannot remove it.
Yes. That is exactly Mode B, and it is the reason the app exists. Stores without Shopify Payments cannot get local-currency checkout from Shopify, so the honest version is display-only conversion plus a clear notice about the checkout currency.
Yes, both apply to Mode B display conversion only.
The first two are on every plan, including Free. You set them per currency on the Currencies screen, on the row that shows you the live rate. Only the third, the targeted rule, needs Pro, because it targets an audience rather than a currency.
Precedence is fixed and documented: a targeted rateOverride rule wins, then a manual rate, then a markup on the provider rate, then the raw provider rate. Rounding is applied after that, using one of nearest, up, down, charm99, charm95 or charm00, with correct handling for 0-decimal currencies like JPY and 3-decimal currencies like KWD. Its own order is a rounding rule that matched the shopper, then a rule for the shopper's country, then a rule for the currency they are seeing, then your store default. Country beats currency there for the same reason it does everywhere else in the app: it is the more specific description of a shopper.
Worth knowing before you install, because these come up constantly in cross-border selling and none of them is a currency-converter problem:
Four things, and they are all checkable rather than adjectives:
Crypto and precious metals are the fifth, if you need them. What we do not claim is a bigger currency list than anyone else. The codes on offer come from the rate providers, not from us, and a number in an app listing is not by itself a feature.
The storefront code is a theme app extension, not a script tag. It is a single JavaScript file plus a small stylesheet, held together to under 15 KB gzipped, and it loads asynchronously.
It is built to avoid layout shift rather than to fix it afterwards. Price nodes are cloaked before paint, converted once the config arrives, then revealed, so a shopper does not watch a price change under their cursor. Rates are cached server side, and concurrent requests for the same base currency are collapsed into one upstream call, so a traffic spike does not turn into one provider request per shopper.
Different sources for different asset classes:
The server refreshes its rate board at most once a minute: a cached board younger than that is served without touching a provider. The config response is then cached in the shopper's own browser for five minutes, so a rate on screen is usually a few minutes old rather than seconds old. That is deliberate, because a currency converter does not need tick-by-tick pricing and the alternative is a network round trip on every page view. A slow provider cannot hold your page hostage either: the storefront script gives up waiting after three seconds and reveals your base prices.
Four layers, in this order:
Metals are XAU (gold), XAG (silver), XPT (platinum) and XPD (palladium). Crypto is whatever Coinbase quotes, which is a large and changing board of coins, tokens and stablecoins, so it is not a fixed list.
Both need the Pro plan. The classifier enumerates metals and fiat and treats everything else as crypto, which means it fails closed: an unrecognised code is gated rather than leaked to a store that has not paid for it. Free and Growth are fiat.
Because Shopify has no API for it. There is no Admin API mutation that writes a shop's currency formats, so no app can do this step for you. Any app that claims otherwise is either asking you to do it too, or injecting prices some other way.
The step is to wrap the amount in a cc-money span in both HTML fields under Settings, General, Currency formatting. The app gives you the exact snippet to paste, then reads both fields back from your store and reports each one as done or not done. You are not asked to self-certify. Skipping it is the single most common reason a merchant says "I do not see the currency change on my live store": with no wrapper there are no price nodes to convert.
The second manual step is enabling the app embed in the theme editor, which Shopify also requires a human to do. Two steps, both visible in the in-app setup guide, both verified rather than assumed.
CurrencyCraft stores the shop configuration needed to provide currency conversion. Storefront analytics are disabled by default at launch, and the app does not request order access or advertise revenue analytics. See the privacy policy for retention and data requests.
Yes. Billing runs through Shopify's own subscription billing, so you change or cancel the plan the same way you do for any other Shopify app, and new paid subscriptions start with a 30-day trial after Shopify approval. There is no contract and no cancellation step that involves emailing anyone.
Uninstalling removes the app's session immediately. Roughly 48 hours later Shopify sends the shop redact webhook and the app deletes your shop record along with your currencies, rules and analytics.
One thing to know: the cc-money wrapper you pasted into your currency formatting is a setting in your Shopify admin, not in the app, so it stays there after you uninstall. It is inert HTML with the app gone, but if you want a clean removal, put those two fields back the way they were.
Up to 5 fiat currencies including the store currency. Growth is $4.99/month and removes the currency cap. Pro is $9.99/month and adds crypto and metals, targeting rules and scheduling. New paid subscriptions have a 30-day trial after approval in Shopify. Saved settings remain after a downgrade, but paid rules and unsupported crypto/metal conversion stop. The full split is on the pricing page.
Still unsure which mode your store lands in? The app detects it on install and shows you, and you can override it.