Catalogs: Custom Pricing and Availability

SellUpdated August 18, 2026 · Reviewed by Peasy Team

The Catalog page is where you configure what each catalog actually contains — which items are available and at what price. To create and manage catalogs themselves, see Catalogs.

Important: Catalogs control both custom pricing AND availability. For example, if a Brand has 10 items they sell, they might make only 8 of them available to Distributors (via a "Wholesale" catalog) because 2 are exclusive to direct-to-store sales (in a "Retail" catalog). This means catalogs control not just what price customers see, but which items they can see and purchase at all.

How to Get There

Go to Sell > Items to sell in the sidebar.

Base Item Prices vs. Catalog Prices

Peasy keeps two layers of price for each item:

  • Base item prices are the prices stored directly on the item. They apply to any customer who doesn't have a catalog assigned, and they're the fallback any catalog uses when it doesn't have its own override for that item.
  • Catalog prices are overrides that belong to a specific catalog. They only affect customers who are assigned to that catalog or who reach it through your storefront catalog settings.

The catalog selector on Sell > Items to sell is what decides which of these two layers you're editing. To edit base item prices, open the catalog dropdown and pick Clear selection at the top — the page then shows each item's base price and editing a cell updates that base price. To edit a catalog's prices, pick that catalog from the dropdown — editing a cell creates or updates the override for just that catalog. This is true for every catalog, including the one you've marked as the default.

Heads up if you're used to older behavior: Picking the default catalog and editing prices used to write straight through to the base price (so the change applied to every customer). It no longer does. Editing the default catalog now writes a catalog-specific price like any other catalog, and only affects customers assigned to it. If you want a price change to apply to everyone, edit it from Clear selection instead.

Selecting a Catalog

Look for the catalog selector in the toolbar (it shows a colored badge with the current catalog name). Click it and choose the catalog you want to view or edit.

You can also create a new catalog directly from here — type a new name into the selector dropdown and click Create New Catalog.

Your last pick is remembered, so the page reopens with the same catalog you were working in. To switch back to the base-item-prices view, open the dropdown and choose Clear selection at the top.

What "Default" Means on a Catalog

A catalog marked as Default is the one Peasy preselects for new customers you create. It is separate from the starred default storefront catalog, which you choose under Configure > Storefront. The Default label does not mean "this catalog secretly edits base prices." If you want every customer to see a new price, edit base item prices from Clear selection, not from the default catalog.

Setting Prices

Prices are set per sell variant (for example an 8oz jar and a 12-case are priced separately), so expand a product's family row to reach its variant rows.

With a catalog selected:

  1. The $ per unit column shows prices for that catalog.
  2. Expand the product's family row, then click a variant's $ per unit cell to edit it inline.
  3. Changes save automatically — no need to click a save button.

Variants that don't have a custom price for the selected catalog show the base item price (slightly dimmed under a Base: label). Once you edit a price, that variant gets a custom override for that catalog.

To remove a custom price (so the variant falls back to the base item price), clear the price field.

To edit base item prices directly, pick Clear selection from the catalog dropdown — the $ per unit column then shows and edits each variant's base price.

Bulk Editing Prices

For larger catalog updates, open the bulk pricing editor instead of clicking each cell:

  • Click the three-dot menu next to the catalog selector and choose Edit pricing, or
  • Open the $ per unit column menu and choose Edit in bulk, or
  • Select multiple rows in the items table and click Edit pricing in the selection toolbar.

The editor opens a spreadsheet with one row per active sell item and these columns:

  • Item — for reference (read-only, always shown). Hover over a shortened Item name to see the full name.
  • Unit and Category — for reference (read-only, shown by default)
  • COGS — the average cost per unit, pulled from receipts (shown by default)
  • Sale price — what customers pay (shown by default)
  • Margin % — calculated as (sale price − COGS) / sale price. Capped below 100% (the formula has no answer at or above 100%). Hidden by default.
  • Markup % — calculated as (sale price − COGS) / COGS. Useful when you think in cost-plus terms (a $3 item sold for $10 is a 233% markup, or a 70% margin — same transaction, two views). Hidden by default.
  • Visibility — shown by default; see From the bulk pricing editor below. With no catalog selected the column shows empty cells, since there's nothing to toggle yet.

Click the N of X columns showing button in the toolbar to choose which columns are visible. Item can't be hidden; every other column (including Visibility) can be toggled independently, and Reset restores the default set.

The three pricing columns stay in sync — edit any one and the other two recalculate from COGS.

The list opens sorted by Item name (A–Z). Use the search bar at the top of the editor to narrow the list by item name, category, or unit. The adjacent Category filter lets you pick one or more categories and only show their items. Click any column header to sort by that column instead — an up or down arrow shows the current sort direction. Rows stay in place while you edit, even when you change a value in the sorted column. Click the heading again to re-sort using the latest values and reverse the direction; a third click clears the sort.

You can:

  • Edit any Sale price, Margin %, or Markup % cell directly. Editing margin or markup recalculates the sale price from COGS.
  • Select rows with the row checkboxes (or Select all in the header), then click Edit price, Edit margin, or Edit markup to apply the same value to every selected item.
  • Copy and paste a column of values from a spreadsheet into any editable column. In the Visibility column, checked, visible, true, and 1 mean visible; unchecked, hidden, false, and 0 mean hidden. Capitalization doesn't matter. Invalid pasted values are skipped and reported without changing those cells.

Changed cells are highlighted and a changed counter appears in the footer. Nothing is saved until you click Save — use Cancel to discard your edits. Saving changes to more than five items opens Confirm pricing update, where you can review how many items are marked as changed and either cancel or confirm the save.

If any selected items don't have COGS, margin and markup can't be calculated for them. Peasy will offer to skip missing COGS and apply the value only to the items with a known cost.

Hiding Items from a Catalog

Visibility is set per sell variant and is a catalog-level setting — you need a catalog selected (including the default) to see or change it. You can toggle it from either the items table or the bulk pricing editor; both control the same setting.

From the items table

Visibility lives in the Visibility column (the eye icon) — expand a product's family row to reach its variants. When you have a catalog selected, each variant's eye is clickable:

  • Visible (green eye) — The variant is available in this catalog
  • Hidden (red eye) — The variant won't appear for customers in this catalog

Click the eye to toggle visibility — this saves immediately. Under Clear selection (base prices) the Visibility column shows a dimmed placeholder eye, since there's no catalog to hide the item from.

From the bulk pricing editor

With a catalog selected, the bulk pricing editor's Visibility column shows a checkbox per row — checked means the item is visible in that catalog, unchecked means it's hidden. Unlike the items table's eye icon, this doesn't save right away: it's a pending change like an edited price, included in the changed counter and only applied when you click Save.

Without a catalog selected (Clear selection), the Visibility column's cells are empty — hover the info icon in its header for a reminder to pick a catalog first.

Both ways of hiding items are useful for creating curated catalogs — for example, hiding retail-only items from your wholesale list.

Assigning a Catalog to a Customer

  1. Go to Sell > Customers in the sidebar.
  2. Open the customer's detail view.
  3. In the Catalog dropdown (in the Details section), select the catalog.
  4. The change saves automatically.

That customer will now see their assigned prices whenever you create an order for them.

How Prices Apply to Orders

When you create a sales order and select a customer:

  • If the customer has an assigned catalog, items use the custom prices from that catalog.
  • If an item doesn't have a custom price in the customer's catalog, it falls back to the base item price.
  • If the customer has no catalog assigned, every item uses the base item price directly.

You don't need to do anything special — the right prices appear automatically based on the customer.

Storefront

When a wholesale customer signs in to the Storefront, Peasy shows the catalog assigned to that customer. If they haven't been assigned a catalog, they see the default storefront catalog. Under Configure > Storefront, turn on each catalog you want available and star one enabled catalog as the default. Every enabled storefront requires one. Logged-out visitors see its pricing only when Require login to see pricing is off.

Good to Know

  • Each customer can have one catalog at a time.
  • Prices and visibility changed from the items table save automatically — there's no save button. In the bulk pricing editor, both are pending until you click Save.
  • Items without a catalog-specific price fall back to the base item price.
  • The catalog marked Default is the preselect for new customers. The starred default storefront catalog is a separate choice under Configure > Storefront.

Related

Was this article helpful?