A catalog’s prices are kept with the catalog itself and never appear under Products → Price Lists. Use a price list for prices that apply to anyone matching a rule, such as a channel, a market or a quantity, and a catalog for terms agreed with a particular audience. See Price Lists.
Reviewing Catalogs

The Status filter narrows the list to Active or Inactive, Add filter offers the created and updated dates, and the menu at the end of a row offers Edit and Delete.
The list does not show who each catalog is assigned to, so two catalogs covering the same audience cannot be identified from this screen. Open a catalog to see its Audiences card.
How to Create a Catalog
Add catalog opens a five-step wizard. Nothing is created until the last step, and Back can be used at any point.Details
- Name - What your team calls the agreement, such as Wholesale.
- Description - An internal note about what the agreement is for. Shoppers never see it.
Audience

- Audience type - Company or Customer group.
- Audience - The company or group itself. A company assignment covers that company and every sub-unit below it, so assigning to a parent covers its divisions.
Products

Pricing

- Normal prices - Your usual shop prices, unchanged.
- Prices I enter for this catalog - A price you set yourself for each variant.
- A percentage off base prices - Your shop prices adjusted by a percentage.
Review

A new catalog is always created inactive and has no effect until it is activated. Enter its prices first, then activate it.
How a Catalog Prices Its Products
The Pricing card on the catalog’s page holds one of three choices. The choice decides how the catalog works out its prices, and which other controls appear beside it.Normal Prices
The catalog charges your usual shop prices and carries no pricing controls of its own. Use it when the catalog exists to decide which products its audience can see rather than what they pay.Prices I Enter for This Catalog
The catalog charges a price you set for each variant, in each currency you sell in. Prices are set in a grid that opens over the catalog page, or loaded from a CSV file. There is no percentage setting in this mode. A price you enter is stored on the catalog, so changing the product’s own shop price later leaves the catalog’s price exactly as you set it.
- Click Enter prices. Each variant is listed with its SKU, a From qty, a Price and a Compare-at price, in the currency shown at the top. The dropdown there switches to your other currencies, each priced separately.
- Double-click the Price cell, type the price and press Tab. A single click only selects the cell, so typing straight after one does nothing.
- Click Save prices. The grid counts unsaved changes as you work, and confirms how many prices were saved.
Quantity Tier

- In the empty row under the variant, type the quantity the break starts at under From qty.
- Type the price for that quantity in the row that appears.
- Click Save prices.
Importing and Exporting These Prices
Import and Export on the Pricing card move this catalog’s prices as a CSV file. This is the practical way to load an agreed price list a buyer has sent you, or to set prices for many products at once instead of entering them one by one.- SKU and Price are required.
- Currency, Minimum quantity and Compare at Price are optional.
A Percentage Off Base Prices
When using the Percentage Off Base Prices model, the catalog works its prices out from your shop prices rather than storing its own, so changing a product’s shop price changes what this audience pays at the same time. There is no grid and no import in this mode, because there are no individual prices to enter.- Percentage - How much to adjust your shop prices by. A discount is entered as a negative percentage, and an increase as a positive one.
- Quantity tiers - A deeper percentage from a given quantity upward, which is how a bulk discount is set up without pricing each variant by hand. Each tier takes its own percentage and the quantity it starts at, and a catalog can hold ten tiers at most.
- Adjust compare-at prices - Whether the compare-at price is adjusted by the same percentage. With it off, the compare-at price a shopper sees crossed out stays as it is on the product.
Each tier is worked out from your shop price, never from the tier below it. A catalog set to 10% off with a tier of 20% off from fifty units charges twenty percent off the shop price at fifty, not twenty percent off the already-discounted price.
A catalog carrying tiers but no overall percentage charges your shop prices until a line reaches the first tier, which is how an agreement that gives no discount below a case is set up.
How to Edit a Catalog
Everything set in the wizard can be changed afterwards from the catalog’s own page, which is laid out in cards.- Products - Add products adds more, and each row offers Remove from catalog. Each row also carries its own Minimum and Multiple, which override the catalog-wide terms for that product.
- Catalog - The name and the internal description.
- Pricing - The same three choices as the wizard, with whichever controls that choice carries beside them.
- Commercial terms - The smallest quantity and order value this agreement accepts, described in the next section.
- Audiences - Assign adds another company or group, and each row offers Remove. A catalog can serve several audiences at once.
Commercial Terms

- Minimum order quantity - The fewest units a buyer may take of one product. A smaller quantity is refused in the cart, and the message names the quantities they can order instead.
- Order multiple - The step size above that minimum. A multiple of 24 allows 24, 48 and 72 but not 30. Steps are counted from the minimum, so a minimum of 50 in steps of 24 allows 50, 74 and 98.
- Order minimums - The smallest total an order may come to, set separately for each currency. Only the items count towards it, so more expensive delivery method does not make up the difference. Buyers see how much more they need to add, and cannot check out until they reach it.
- The product’s row on this catalog, where an override has been set.
- The catalog’s own Commercial terms.
- The product’s own setting on its product page, used when no catalog states one.
Quantity rules apply to buyers shopping for themselves. An order your team builds in the dashboard is not held to them, so staff can enter a quantity that was agreed as an exception.
How to Activate or Deactivate a Catalog
Activate at the top of the catalog page puts the agreement in force after a confirmation. Its audience then sees the products it lists and pays its prices. A catalog with no audience cannot be activated, unless it is a sales channel’s default catalog. Otherwise there would be nobody for it to apply to. Deactivate stops it applying. Everything the catalog holds is kept, so activating it again makes its terms apply again.How to Delete a Catalog
Delete catalog under More actions removes the catalog, its audience assignments and its price list with every price in it. The products themselves stay in your store. This cannot be undone, so deactivate the catalog instead when the agreement might be needed again.Which Catalog Applies
A buyer can be covered by more than one catalog, and two rules decide which one prices their order. Only one kind of audience is used. A buyer’s company is consulted first, and their customer groups are used only when no catalog is assigned to their company or to any company above it. A company buyer is therefore never priced by their customer group’s catalog, which is why trade tiers belong on the companies themselves. Where neither applies, the sales channel’s default catalog is used, if one is set. The closest company to the buyer decides, and then the cheapest price. The buyer’s own company is checked first, then the company above it, and so on up the company hierarchy. The first one carrying a catalog that prices the product wins, even where a company further up would have charged less. A division’s own catalog therefore prices its buyers ahead of its parent company’s. Where one company carries more than one catalog, the buyer pays the lowest price any of them gives for the quantity being bought. Quantity breaks count in that comparison, so which catalog wins can change with the quantity ordered. Take one catalog charging 40.00 a unit and another charging 45.00 that drops to 35.00 from ten units: a buyer taking nine pays 40.00 under the first catalog, and a buyer taking ten pays 35.00 under the second.How to Check What a Buyer Will Pay

- Navigate to Orders → Draft Orders and click New Order.
- Pick the business under Company (optional). The customer list then offers only the people who buy for it.
- Choose the customer, add the product under Add a variant, and click New Order.
A draft order holds stock for as long as it exists, so a draft started only to check a price takes those units out of what you can sell until it is removed.
Ways to Use Catalogs
Agreed Prices for One Business
Create a catalog, assign it to the company, leave the Products step empty and choose Prices I enter for this catalog. Then enter each price on the catalog page, save them, and click Activate, because a new catalog does nothing until it is activated. The company’s buyers see your whole range and pay your agreed prices. This is the most common arrangement, and leaving the product list empty is what keeps their view of your range unchanged.A Range Only Some Buyers See
Create a catalog, assign it to the company or group, and add only the products that audience should have. Its buyers then see exactly those products and nothing else, as long as no other active catalog also covers them. Where an audience has a second active catalog that lists products, its buyers see both catalogs’ products together.An Extra Product for One Audience
Letting one audience have access to a product that nobody else can buy takes two catalogs, because a catalog restricts its audience to the products it lists. A catalog holding that product on its own would leave its audience being able to see only that one product and nothing else.- Build a Main range catalog holding the products everyone should see, and assign it to a catch-all customer group, or set it as the channel’s default catalog.
- Build a second catalog holding the special product, and assign it to the audience that may buy it.
- Assign the Main range catalog to that audience as well, and activate both.
A catalog can only narrow what a sales channel already publishes. A product that is not published to the channel cannot be reached by adding it to a catalog, so publish the special product first and let the catalogs decide who sees it. See Sales Channels.
Further Reading
- Price Lists - Prices that apply to anyone matching a rule
- Companies - The businesses and divisions a catalog is assigned to
- Groups - The other kind of audience a catalog can have
- Draft Orders - Building an order on a buyer’s behalf
- Products - The products a catalog covers

