Markets

A market is one place you sell the same catalog.

It carries its own currency, language, country, tax rules, checkout policy and list of products — so the catalog stays single while everything around it varies.

The Markets page lists them and edits each one in an inline panel.

Prices, taxes, shipping rates and feeds all resolve by the market an order belongs to. That is the whole idea: an order does not carry a copy of your pricing rules, it carries a market, and the rules are read from there.

Six market types

web
marketplace
retail
wholesale
social
mobile

What a market sets

Each market fixes four things about where it sells:

• Currency
• Language
• Country
• Timezone

Underneath it, the market record is a Channel, with ProductChannel recording per-market availability and VariantPrice holding a price per market and currency.

Which products sell where

Every product carries a Channels card listing every market.

Tick a market to make the product available there. You can also give the product a different title or description for that market, where the wording should differ rather than the product.

There is one consequence to watch for. A product ticked into no market is invisible on every market-scoped surface, including the feed. It is not a draft, and it is not unpublished — it simply has nowhere to appear. A product that seems to have vanished from the storefront is worth checking here first.

Prices per market and currency

A price is stored once per variant, market and currency.

That means a EUR market can hold a real euro price — the number you chose — rather than a conversion of a dollar figure. Rounded pricing survives, and so do the price points that only make sense in a particular market.

Where no exact match exists, the storefront converts from the price that does exist rather than dropping the product.

exact price for this variant, market and currency?
    ↓ yes            ↓ no
show it          convert from the price that exists

The fallback is deliberate. The alternative — hiding a product because nobody set a price in that currency yet — turns an incomplete price list into a broken catalog.

Tax and checkout policy

Each market chooses its own commercial rules:

• Manual tax rates or Stripe Tax
• Its own rate
• Whether prices are tax-inclusive or tax-exclusive
• Whether coupons apply
• Whether loyalty applies
• How many loyalty points buy a dollar of discount

Tax-inclusive versus tax-exclusive is the one that surprises people. It is not a display preference — it changes what the number on the product page means, and different countries expect different answers.

Translations

Products, collections and categories each get a translation card, where you fill in a language's name, description and metadata.

Each language is a separate stored row, so adding one duplicates nothing. You are not cloning a product to translate it, which means the product's price, stock and options stay single no matter how many languages it is sold in.

Feeds scoped to a market

A feed is either Global or bound to one market.

So the same catalog can be merchandised in a different order per market — a different set of anchors, a different sense of what counts as new — without maintaining a second catalog to do it.

The public product feed

The store serves its live catalog as structured data, for Google Merchant Center and for AI shopping agents.

It is paginated, so a large catalog is fully readable rather than truncated at some limit.

Nothing is exported and nothing is scheduled. The data is generated on request, from whatever the catalog says at that moment — so there is no stale feed to re-upload after a price change, and no sync job to check.

The default market is protected

The market whose slug is default cannot be deactivated or deleted.

Every order needs a market to resolve its prices and taxes against, so the store keeps one that cannot be removed out from under it.

Carried, but not in the form

The market record also holds three values the Markets form does not expose:

• A return window
• A storefront theme
• A locale list

They exist on the record and are used, but you will not find fields for them on this page.

Setting up a market

Create the market and set its currency, language, country and tax rules first. Everything else resolves against those.

Then open each product and tick the markets it sells in, overriding the title or description where the wording should differ.

Add a price in the market's currency on the variants that need an exact figure rather than a converted one — start with the ones where rounding matters and leave the rest to convert.

Scope a feed to the market if it should merchandise differently.

When you are deciding whether something belongs on the market or on the product, use this:

A market answers "what are the rules where I am selling?"; a product answers "what am I selling?" — if a value changes when you cross a border, it belongs to the market.

Related