Create Your First Market

What Is a Market?

A Market is a group of countries that share a currency, language, and tax policy. When a visitor arrives at your storefront, Cartly detects their country automatically and shows them the right prices, language, and tax treatment for their market.

Every store starts with one Primary Market. The Primary Market is the fallback for visitors from countries not covered by any other market. It cannot be deleted or deactivated.

Create a New Market

1. Go to Settings → Markets in your admin panel.
2. Click Add Market.
3. Give the market a name (e.g. "Europe").
4. Select the countries that belong to this market.
5. Choose the Base Currency for this market (e.g. EUR).
6. Set the Default Language — the language shown to visitors by default in this market.
7. Optionally add more Available Languages — visitors can switch between them using the language switcher on your storefront.
8. Choose the Tax Mode:
   • Tax Inclusive (VAT-style) — the price you set already includes tax. At checkout, Cartly calculates how much of the total is tax. Use this for European VAT markets.
   • Tax Exclusive (sales-tax style) — the price shown does not include tax. Tax is added at checkout. Use this for US-style sales tax markets.
9. Choose the Duty Mode:
   • DDP (Delivery Duty Paid) — your store covers import duties. Customers see a final all-inclusive price.
   • DDU (Delivery Duty Unpaid) — the buyer pays duties when the package is delivered.
10. Save the market and set it to Active.

Setting a Market as Primary

If you want to change which market is the primary one, open the market you want to promote and click Set as Primary Market. A confirmation dialog will explain the impact on translations before the change takes effect.

Note: The primary market's default language is used as the source language for translations across your store. If you promote a non-English market to primary, existing English translations will become inactive until you provide new source-language translations.

Per-Country Language Switcher

If a market has multiple available languages, a language switcher appears in the storefront header. Visitors can switch between languages. Their choice is saved in a cookie for future visits. Language names are shown in each language's own script ("Deutsch", "русский", "ქართული").

Notes

• A country can only belong to one market at a time.
• Removing a language from a market does not delete your existing translations — it only removes the language from the storefront switcher.
• Markets require the Multi-Currency feature to be active if the market uses a currency different from your base currency.