Skip to main content

Item Price Sets

Price Sets define reusable pricing across items/customers. Retail: one per item. Wholesale: multiple allowed, priority-based. Groups bundle sets. Changes propagate automatically. Item-level pricing always applies if no set matches.

Item Price Sets

Price Sets let you define a named, reusable set of prices and apply it across many items at once. This feature serves both retail and wholesale. Instead of editing prices item by item, you manage them in one place and let the price set push that pricing everywhere it's assigned.

This is an optional feature. If you don't use Price Sets, your items continue to use their own item-level prices exactly as they do today. Item-level pricing is always the fallback when no price set applies.

When to use Price Sets

Price Sets are useful when you want to:

  • Define consistent pricing across a category or set of items.
  • Run a retail sale or promotion across a category of items without touching each item's price.
  • Maintain wholesale tiers (e.g., "Tier 1 Wholesale," "Tier 2 Wholesale") and assign a tier to one or more customers at once.
  • Give a specific customer their own negotiated pricing (e.g., "Premier Client Pricing") that overrides your standard rates.
  • Manage clearance pricing that takes precedence over everything else.

A single price set can be applied to one item, hundreds of items, or many customers, and when you update the price set, the change flows to everything it's attached to automatically.

Key concepts

Channel scope: Retail or Wholesale

Every price set is scoped to either retail or wholesale. A price set never applies to both.

  • Retail price sets are not tied to any customer. Only one retail price set can be active on an item at a time.
  • Wholesale price sets can be tied to customers, and an item can have multiple active wholesale price sets at once. When that happens, Priority decides which one wins (see below).
The four price fields

Items carry four prices. A price set can override any of them:

Field

What it is

Retail price

Default retail price

Retail sale price

Retail discount/sale price

Wholesale price

Default wholesale price

Wholesale sale price

Wholesale discount/sale price

A price set can target the default price, the sale price, or both.

Unit of measure (UOM)

A price set has a UOM, and it only applies to items with a matching UOM (Each applies to Each, Gram applies to Gram, and so on). The default is Each. If the UOMs don't match, the price set is ignored for that item and the item's own price is used.

Active / Inactive

You turn a price set on or off with an Active/Inactive status. There is no end-date scheduling. When a sale is over, you deactivate the price set.

Priority: how conflicts are resolved

When more than one active price set could apply to the same item (only possible on wholesale), Priority decides which one wins.

Lower priority number = higher precedence. A price set with priority 1 beats one with priority 30.

A typical priority scheme looks like this:

Use case

Priority

Precedence

Clearance

1

Highest — beats everything

Sales / promo

2

Customer-specific

10

Customer group / tier

30

Default

50

Lowest

So a customer-specific price set (priority 10) overrides a Tier 1 price set (priority 30), which overrides your default (priority 50).

If two active price sets are tied on priority, the lower price is applied.

Item-level pricing always sits underneath all of this as the final fallback if no price set resolves.

Note: Orders created through the API always use the price sent in the API call. Pice set resolution does not override an API-supplied price.

Price Set Groups

A Price Set Group is an organizational tool that bundles price sets together and makes assigning them to items easier. Groups are optional, but recommended for keeping things organized.

A group has:

  • Name
  • Channel scope (Retail or Wholesale)
  • UOM (defaults to Each)
  • Status (Active / Inactive)

The power of a group is in assignment: when you assign items to a group, every price set in that group is applied to those items. Add a new price set to the group, and it automatically picks up all of the group's items. This saves you from attaching price sets one at a time.

Where to find Price Sets

Settings → Items → Price Sets (main grid)

This is your home screen for viewing and managing all price sets and price set groups. From here you can:

  • See all price sets and groups in one grid
  • Search by price set name or group name
  • Click a group name to open the group
  • Click a price set name to open the price set
  • Create New Price Set Group
  • Create New Price Set
  • Export
The Item screen (Item Price section)

On an individual item, the Price Sets section shows what's attached to that item. Retail and wholesale assignments are shown separately.

  • Wholesale: an item can show multiple assigned price sets.
  • Retail: only one can be assigned. Remove it to clear the assignment, or add/change it to swap in a different one.

Your existing Price History table on the item is unchanged.

Destination (B2B customer) screen

For wholesale, you can view and manage which price sets are assigned to a customer directly from that customer's (destination) profile.

Common tasks

Create a price set group
  1. Go to Settings → Items → Price Sets.
  2. Click Create New Price Set Group.
  3. Enter Name, Channel Scope, UOM, and Status.
  4. Add or remove price sets from the group.
  5. Add or remove items from the group (use Bulk Manage Items to open the bulk-assign screen).
Create a price set
  1. Go to Settings → Items → Price Sets.
  2. Click Create New Price Set.
  3. Fill in:
    • Group — optional but encouraged. If you pick a group, Channel Scope and UOM default from the group.
    • Name — free text; you can rename it later (e.g., "Spring Flower Sale").
    • Channel Scope — Retail or Wholesale.
    • UOM — defaults to Each; must match item UOM to apply.
    • Price — the default price.
    • Sale Price — the discount/sale price.
    • Priority — a whole number; lower wins.
  4. Save. The price set opens in a view state; click Edit anytime to change details.
Assign a price set to an item (directly)
  1. Open the item and find the Price Sets section.
  2. Click to add a price set. In the Add Price Set modal you can:
    • Search and attach a price set or a price set group.
    • Only active price sets are shown.
    • Results are scoped to the item's UOM.
  3. For retail, if a retail price set is already assigned, adding a new one will swap it — you'll see a warning before it replaces the existing assignment.
Bulk-assign items to a group
  1. Open a Price Set Group.
  2. Click Bulk Manage Items.
  3. On the bulk screen, add or remove items from the group. This follows the same pattern as bulk tag management, so if you've done bulk tagging before, this will feel familiar.
Assign a price set to wholesale customers

A single wholesale price set can be assigned to many customers (1-to-many). For example, "Tier 1 Pricing" might be assigned to 20 customers, while "Stizzy Pricing" goes to Stizzy only.

You can manage these assignments from either:

  • The price set screen, or
  • The destination (customer) profile.

Because the assignment lives on the price set, updating the price set updates pricing for every customer it's assigned to — you don't maintain separate per-customer price records. On wholesale orders, the applicable price is resolved per line item.

Edit or rename a price set

Open the price set from the grid, click Edit, change the name, prices, priority, status, or other fields, and save. Changes propagate to every item and customer the price set is attached to.

Turn a sale on or off

Activate the price set when the promotion starts; deactivate it when the promotion ends. There's no scheduled end date, so deactivation is manual.

How group assignment behaves

Understanding these four behaviors helps avoid surprises when you work with groups:

Action

What happens

Add a price set to a group

The price set picks up all of the group's items. Any items you'd assigned to that price set directly stay as they were.

Remove a price set from a group

The price set is detached from the group's items. Direct assignments survive. The price set may end up with no items if it had none assigned directly.

Add an item to a group

Every price set in the group is applied to that item.

Remove an item from a group

All of the group's price sets are detached from that item.

In short: group assignments and direct (item-level) assignments are independent. Removing one never deletes the other.

Audit log

Each price set keeps a simple audit log so you can see what changed and when.

Quick reference

  • Price Sets are optional; item-level prices are always the fallback.
  • A price set is retail or wholesale, never both.
  • Retail: one active per item, not tied to customers.
  • Wholesale: multiple active allowed per item, can be tied to customers; Priority resolves conflicts (lower number wins; ties go to the lower price).
  • UOM must match the item for a price set to apply (default Each).
  • Groups bundle price sets and make bulk item assignment easy.
  • Updating a price set propagates automatically to every item and customer it's attached to.
  • API-supplied prices on orders are never overridden by price sets.

How did we do?

Update Items in bulk

Retail Return Reason Codes

Contact