Selling in Multiple Currencies

Cross-Border Selling with Markets

Cartly's Markets feature lets you sell internationally by displaying prices in your customers' local currency and showing content in their language. You define markets — groups of countries that share a currency and language — and Cartly automatically shows the right prices to each visitor.

What Is a Market?

A market is a group of countries that your store serves under the same currency and language settings. For example, you might create a "Europe" market covering Germany, France, and Austria, using EUR as the currency and offering German and French language support.

Your store always has one primary market (usually your home country). Additional markets are optional — you can sell globally from a single market if you prefer.

Creating a Market

Navigate to Settings → Markets and click Create Market. Fill in:

• Name — A descriptive label (e.g., "Europe", "Asia-Pacific")
• Countries — Which countries belong to this market
• Currency — The currency used to display prices in this market
• Language — The default language for this market
• Tax-inclusive pricing — Enable if prices should include VAT (common in Europe)
• Duty mode — DDU (customer pays import duties) or DDP (you pay duties upfront)

Setting Market Prices

By default, Cartly converts your base prices to the market currency. For precise control, you can set specific prices per market:

1. Open a market from Settings → Markets
2. Click Manage Prices
3. For each product variant, enter the exact price to display in that market
4. Optionally set a "Compare At" price to show the original price with a strikethrough

Market prices override the automatic conversion for those variants.

Translating Content

Navigate to Settings → Translations to translate your product titles, descriptions, collection names, and page content into the languages you support. Customers in a market see translated content if a translation exists for their language; otherwise, your default language is shown.

How Customers See Markets

Cartly detects your customer's country automatically and routes them to the matching market. This means a visitor from Germany sees prices in EUR and your German translations — without them needing to select anything manually.

You can also expose a language/currency switcher in your theme for customers who want to change their region manually.

Excluding Products from Markets

Some products may not be available in every market — for regulatory reasons or because you do not ship a specific item to certain countries. Open a market and use the Exclusions tab to hide specific products from that market's storefront.

Primary Market

The primary market is the default for customers whose country does not match any configured market. It is also used as the fallback for pricing and language. You can change which market is primary at any time from the market detail page.

Headless / API Access

If you are using a custom storefront via the Headless Storefront API, prefix your API requests with the locale code to receive market-aware pricing and translated content. For example, GET /storefront/v1/de/products returns products with EUR prices and German titles for your Europe market.