Markets

Markets let you sell the same catalog in different places with different rules. Use one when you sell in another country or currency, or through another channel such as a marketplace or a wholesale shop.

A market is one place where you sell your catalog. Each market has its own currency, language, country, tax rules and checkout policy. It also has its own list of products. You keep a single catalog, and only the things around it change from market to market.

The Markets page lists your markets. You edit each one in a panel on the same page.

Litestore works out prices, taxes, shipping rates and feeds from the market an order belongs to. An order doesn't store a copy of your pricing rules. It stores its market, and Litestore reads the rules from there.

Six market types

web
marketplace
retail
wholesale
social
mobile

What a market sets

Each market sets four things about where it sells:

• Currency
• Language
• Country
• Timezone

In the database, a market is a Channel record. ProductChannel records which products are available in each market. VariantPrice stores a price for each market and currency.

Which products sell where

Every product has a Channels card that lists all your markets.

Tick a market to make the product available there. If the wording should change in that market but the product stays the same, you can give it a different title or description there.

Watch out for one thing. If a product isn't ticked for any market, it doesn't appear anywhere that depends on a market, including the feed. It isn't a draft, and it isn't unpublished. It simply has nowhere to show. If a product seems to have disappeared from your storefront, check this card first.

Prices per market and currency

Litestore stores one price for each combination of variant, market and currency.

This means a EUR market can have a real euro price that you chose, not a converted dollar price. Your rounded prices stay rounded, and you can use price points that only make sense in one market.

If there's no exact price, the storefront converts from a price that does exist. It doesn't hide the product.

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

This fallback is intentional. Hiding a product because nobody has set a price in that currency yet would turn an unfinished price list into a broken catalog.

Tax and checkout policy

Each market sets its own rules for tax and checkout:

• 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

The tax-inclusive setting surprises people most. It isn't just about how prices are displayed. It changes what the number on the product page means, and different countries expect different answers.

Translations

Products, collections and categories each have a translation card. There you fill in the name, description and metadata for a language.

Litestore stores each language as its own row, so adding a language doesn't copy anything. You don't clone a product to translate it. The product keeps a single price, stock level and set of options, however many languages you sell it in.

Feeds scoped to a market

A feed is either Global or tied to one market.

This lets you order the same catalog differently in each market. You can pick different anchors, or treat different products as new, without keeping a second catalog.

The public product feed

Your store publishes its live catalog as structured data for Google Merchant Center and for AI shopping agents.

The feed is split into pages, so a large catalog can be read in full and isn't cut off at some limit.

Nothing is exported or scheduled. Litestore builds the feed each time someone requests it, from what your catalog says at that moment. After a price change, you don't need to upload a new feed or check on a sync job.

The default market is protected

You can't deactivate or delete the market whose slug is default.

Every order needs a market to work out its prices and taxes. Litestore keeps one that can't be removed, so there's always a market to fall back on.

Saved on the market, but not in the form

A market also stores three values that the Markets form doesn't show:

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

Litestore saves and uses them, but you won't find fields for them on this page.

Setting up a market

1. Create the market. Set its currency, language, country and tax rules first. Everything else depends on them.
2. Choose its products. Open each product and tick the markets where it sells. Change the title or description where the wording should be different.
3. Add exact prices where they matter. On variants that need an exact figure, add a price in the market's currency. Start with the ones where rounding matters and let the rest convert.
4. Scope a feed to the market if you want it to order products differently.

When you're not sure whether a value belongs on the market or the product, use this rule:

A market answers "what are the rules where I'm selling?" and a product answers "what am I selling?". If a value changes when you cross a border, it belongs to the market.

Related