Skip to content

Catalogs & contextual pricing

A catalog is not a price list. It is one record holding three things:

  • a price rule — a percentage off your normal price, exact prices per variant, order limits and volume breaks;
  • an optional product list — which products this audience may see and buy;
  • an audience — the company locations, companies or customers it reaches.

You manage catalogs under Catalogs in the store sidebar. A catalog can carry prices only, products only, or both.

Remember that the commercial unit is the branch. A catalog aimed at Sharma Distributors’ Nashik branch changes nothing for their Pune head office.

Create a catalog

  1. Go to Catalogs and choose Create catalog. You only enter a name.

  2. Work the Finish setting up checklist on the catalog page: Set prices, Choose products, Pick the audience, Activate.

  3. Leave it as a Draft until it is right. A draft changes no price anywhere, for anybody.

  4. Activate it when the prices and audience are correct.

The catalog list shows what each one does and who it hits, so you can read a row without opening it — “Distributor Tier A” reads as “−18% · 12 fixed price(s)” and “6 location(s) · 2 company(ies)”.

Setting prices

Overall adjustment

On the Pricing card choose Add pricing, then Decrease by or Increase by a percentage. Two decimals are allowed. This moves every price in the catalog at once, so you do not type prices product by product.

An 18% decrease turns a ₹250.00 namkeen pack into ₹205.00 for Sunrise Retail. Rounding is half-up on paise, so ₹249.99 becomes ₹204.99.

Fixed price per variant

A fixed price is an exact contracted price for one variant, and it always beats the percentage inside the same catalog.

On the Products card, expand a product and type into the Fixed price cell for a variant, then save from the sticky bar. Enter moves down a row, Esc reverts the cell.

Kapoor Apparel keeps 22% off overall, but Cotton Polo / L is pinned at ₹640.00. That row shows FIXED; every other size shows AUTO. Nothing on the storefront reveals that a price was hand-set.

Type 640 or 640.00. Commas are rejected, so 1,240 will not save.

Compare-at prices

On the Pricing card, choose whether the buyer sees your normal price struck through beside the catalog price, or nothing at all.

Kapoor Apparel’s trade catalog hides compare-at prices, so trade buyers never see MRP beside their ₹640.00 — including in the cart. Your consumer storefront still shows MRP as usual.

Order limits: minimum, maximum, increment

Per-variant rules that make buyers order in case-pack multiples. On the Products card, expand a product, open the gear icon on a variant, then Quantity pricing, and set Minimum, Maximum and Increment. Clearing all three removes the rules.

Buyers get the limits on the quantity box, a hint line on the product page and the quick order pad, and a blocking message at checkout: “This item must be ordered in multiples of 12. You currently have 20 in your cart.”

Set Minimum 24 and Increment 12 on a 200g pack, and Sunrise Retail cannot check out with 30 — they must move to 24 or 36.

Volume price breaks

Up to 10 quantity tiers per variant. Reaching a tier drops the unit price on every unit of that line, not just the units above the threshold.

Open the same Quantity pricing panel and choose Add break, then set a minimum quantity and a unit price for each tier. Buyers see a volume table on the product page — “25–99 · ₹800.00 each” — and are charged the tier price on all units.

Cotton Polo / L sits at ₹880.00 with breaks at 25 → ₹800.00 and 100 → ₹720.00. Kapoor Apparel’s 120-piece order bills all 120 at ₹720.00 = ₹86,400.00.

Rules the form enforces: prices must fall as quantity rises, a break price can never exceed the variant’s fixed price, and break minimums must sit inside the order limits and match the increment.

Allow additional promotions

Also on the Pricing card, and on by default. It decides whether a discount code can apply on top of these contract prices.

Switch it off on a price list already 22% off list, so a sitewide 10% code cannot quietly stack it to 32%. Those lines still count toward free-shipping and minimum-order thresholds either way.

The prices CSV

Export the catalog’s prices, edit them in a spreadsheet, and import them back. It round-trips fixed prices, compare-at prices, order limits and volume breaks. Use Products card → Export, then Import.

Also worth knowing before your first import:

  • 5,000 rows maximum per file.
  • Failed rows come back as an errors CSV with a reason column. Kapoor Apparel’s sheet returned “374 row(s) imported” with 6 rows reading “price_cents must be a non-negative integer”.
  • A brand-new catalog exports an almost-empty file. Export only returns variants that already carry a price, an order limit or a break — so set a few prices by hand first, export, then extend the sheet.

Preview prices

Preview prices on the catalog page resolves what a named customer would actually pay, through the same engine the cart uses. Pick a customer, optionally a company location, pick the variants, then Preview.

Asked “why is Sunrise paying ₹205?”, you preview and read back: Source Adjustment, Winning catalog Chain Pricing, ₹205.00, Rules “Min 24 · Multiples of 12”.

It has two blind spots: it does not show volume breaks, and it always previews the Online store channel.

Choosing which products the catalog covers

On the Products card, the dropdown at the top is either:

  • All products — the audience sees everything you sell; the catalog only changes prices; or
  • Selected products only — the audience sees just the products and collections you list here.

Beside it sits Automatically include new products, which keeps a “selected products” catalog current as your range grows. More actions → Remove product availability rules reverts the catalog to All products.

Vinayak Infra’s “Jobsite Supply” catalog includes only the Fasteners and Safety collections, so site buyers never see the consumer power-tool range.

Included, Excluded and All tabs

The Products card lists your whole range across three tabs, with a reason on every row: “Included via collection”, “Excluded manually”, “All products”. Tick rows and use Include or Exclude in the bulk bar, or use the row menu’s Clear rule to drop a manual override.

Include the whole Switchgear collection, then exclude two discontinued models by hand: 46 rows read “Included via collection” and two read “Excluded manually”. A manual exclude outranks a collection include.

The tabs reflect the last built version of the list, so a fresh save can take a moment to appear.

Add collections

More actions → Add collections grants whole collections at once and keeps up as their membership changes. The collections appear as chips under the header; the x removes the rule.

Sunrise Retail’s catalog gets the “Bulk 5kg” collection. A 5kg SKU you add next month is available to them with no catalog edit.

Variant-level availability

Advanced module — off by default. Turn on Variant-level availability in Settings → B2B wholesale, then use More actions → Select variants to publish individual variants rather than whole products.

Kapoor Apparel gets the “Pack of 5” tee variant only; singles are never offered to trade.

Catalog-only products

This one lives on the product, not the catalog. On a product’s Sales channels card, tick Catalog only (nested under Online store). The product then never appears on your consumer storefront, even by link, and exists only for the catalogs that publish it.

A 100m contractor cable drum at ₹18,400.00 never shows in consumer search but sits inside Distributor Tier A.

Audience: who the catalog reaches

The Audience card offers four targets:

TargetHow you add it
Company locationsAdd locations — saves immediately.
CompaniesAdd companies, which covers every branch of that company, present and future.
Location groupsNeeds the Location groups Advanced module (off by default). One catalog aimed at a named set of branches across companies.
Individual customers and segmentsBehind a reveal on the same card. These affect personal shopping only.

Sharma Distributors’ Nashik branch gets Distributor Tier A while Pune stays on Tier B. Switching the ordering branch switches the entire price sheet.

You can also use Attach catalog from a company page. That route is always company-wide — branch-level assignment has to be done from the catalog’s Audience card.

Limits to plan around:

  • 25 catalogs directly assigned to one location, or 50 counting what reaches it through its company and its location groups.
  • 25 company-wide catalogs per company.
  • A price-increase catalog cannot be activated while it is aimed at a dynamic segment.
  • Company buyers never pick up personal or segment catalogs while ordering for their company.

Audience overlap

Under the audience list, Audience overlap names other catalogs that share branches or customers with this one — “Shares 4 location(s) with Festive Promo” tells you four depots sit on two catalogs at once.

It is advice, not a warning. It never blocks a save, and it cannot say which catalog will win on a given product. Overlap is a supported setup, settled by the rule below.

Which price wins

For a company buyer, exactly one tier resolves, and the cheapest price inside that tier wins:

  1. Catalogs assigned to the buyer’s branch.
  2. Otherwise, catalogs assigned to their company.
  3. Otherwise, catalogs assigned to a location group they belong to.
  4. Otherwise, your normal price.

For someone shopping personally the ladder is: catalogs assigned to them by name, then catalogs assigned to a segment they are in.

The most specific tier wins even when it is dearer. Vinayak Infra’s Andheri site has a branch catalog at ₹1,180.00 and a company catalog at ₹1,050.00. The buyer pays ₹1,180.00, because the branch deal is treated as the negotiated one. “Cheapest wins” only decides between catalogs at the same level: two branch catalogs at ₹1,180.00 and ₹1,120.00 give ₹1,120.00, and if two catalogs at the same level carry the identical price, the older one wins, so the buyer always gets the same answer.

Two more consequences:

  • A branch catalog only needs to price the variants that actually differ. Everything it does not price falls through to the company catalog or your normal price. Sparse branch catalogs are fine.
  • The winner is taken whole. You cannot mix a price from one catalog with the volume breaks from another, and the decision is made per variant — two variants in one cart can come from two different catalogs.

Status, schedule and channels

The Availability card limits a catalog to Online store and Point of sale, with an optional start and end date and time in store time. New catalogs start with Online store on and Point of sale off. Changes here save when you click away from the field.

“Diwali Trade Pricing” runs 20 Oct 00:00 to 10 Nov 23:59. On 11 Nov the chains are back on standard trade prices with no manual step.

What buyers see

Every price a signed-in company buyer sees — search suggestions, collection pages, product pages, recommendations, cart and checkout — is the price for the branch they are purchasing for.

If they switch branches, or between company and personal purchasing, with items in the cart, the cart is re-priced and re-checked and they confirm before continuing. See the buyer portal guide.

Who may see prices at all

Two store-wide settings sit above every catalog, in Settings → B2B wholesale.

Prices for signed-out visitors

Three choices:

  • Show prices to everyone — the storefront behaves exactly as before.
  • Swap prices for a sign-in prompt — themes show “Sign in to see prices” where the price was. Buying stays open.
  • Hide prices and block buying — the strictest option. The visitor also gets “Sign in to buy” and no volume table. This one needs the Restricted pricing Advanced module, which you can turn on in the same save.

Kapoor Apparel’s supplier picks the strictest option: competitors browsing anonymously get photos and specs but no rupee figure, and the Google feed carries no prices.

Storefront access (a trade-only store)

Separately from prices, Storefront access → Only signed-in customers can browse closes the shop to the public. A signed-out visitor gets a notice page explaining that the store is for approved trade accounts, with links to sign in and to apply.

Four things stay reachable so business does not stop: sign-in, the wholesale application form, order confirmations, and payment links. Pair this setting with the application form so new businesses have a way in.

Next steps