Skip to main content

Price Books

You can use price books to customize pricing for groups of buyers. With price books, marketplace operators can offer tailored pricing or promotions to target segments, such as wholesale buyers, preferred partners, or members of a loyalty program.

You can configure price books for high-level price adjustments that apply to entire product types, or as granular as adjustments for individual product variants.

How it works​

Price books contain a list of customers granted access to different prices in the storefront, according to the price adjustments on the price book.

Take for example a price book where customers receive adjusted prices of:

  • $19.99 -> $17.99 (-10%) for a coffee drink
  • $6.99 -> $4.99 (-$2.00) for a carrot juice drink

When a customer associated with this price book logs into the storefront, they will see product list prices reflecting the adjusted prices, which can be purchased at these reduced rates.

In both the marketplace and seller order, it will be clearly indicated that the product prices were adjusted using a price book. A tooltip in each order line mentions the name of the price book being applied.

Considerations​

Before you start using price books, consider the following.

Permissions​

To view and manage price books, your account must have the MANAGE_PRICEBOOKS permission assigned through your permission group.

One price book per customer​

A customer can be assigned to only one price book at a time. If a customer is initially added to a price book and later added to a different price book, they will be automatically removed from the price book they were initially added to.

Price adjustment order of priority​

Price adjustments do not stack. If the same product variant is included in multiple price adjustments within the same price book, the following order of priority will be applied to determine which price adjustment to use:

  1. If a variant price adjustment is present, it will be used.
  2. If no variant price adjustment is present, the product price adjustment will be used.
  3. If neither of the above is present, the product type adjustment will be used.

Price adjustments and active orders​

Once an order is created, the product line item price is locked in and cannot be changed:

  • When a price adjustment is added, existing in-progress orders will retain their original price.
  • When a price adjustment is removed, in-progress orders using that price adjustment will retain the adjusted price.

Price adjustments and discounts​

Price adjustments combine with any active sales or vouchers applied to the order. See Combining Discounts and Price Books to learn how discounts and price books stack.

Create a price book​

  1. From the Dashboard, go to Catalog -> Price books.
  2. Select Create price book.
    The Create a price book window appears.
  3. Enter a Name and Description to identify the price book.
  4. Select Create.
    The price book is created and saved.

Next steps​

Add customers and price adjustments to the price book.

Manage price adjustments​

Price adjustments can either increase or decrease prices. When adding an adjustment, the system will display a preview of the updated price.

The revised list price will take effect immediately for any customers assigned to this price book. However, any active orders will retain the list price that was in effect at the time the order was created.

note

You cannot edit price adjustments through the Dashboard once it's been added. To modify a price adjustment with the Dashboard, delete the price adjustment, then add a new one.

Add a price adjustment​

  1. Go to the price book to which you want to define a price adjustment.
  2. Open the tab for the type of price adjustment you want to create.
    You can add the following types of price adjustments to a price book, ordered by the highest to lowest-level granularity:
    • Types: Adjust the price of a product type and all of the products and variants within.
    • Products: Adjust the price of a product and all of its variants.
    • Variants: Adjust the price of a specific variant.
      note

      If you add overlapping price adjustments, the system follows an order of priority to use the most specific price adjustment available.

  3. Select Add adjustment.
  4. Use the search bar to find and select the product type, product, or variant you want to adjust the price of.
  5. Select the appropriate item from the list.
  6. Under Replace the list price with, define the new pricing:
    • To decrease the price:
      1. Select a decrease.
      2. Choose whether to decrease the price by Percentage or Fixed rate.
      3. In the text box, enter the value to decrease the price by.
    • To increase the price:
      1. Select an increase.
      2. Choose whether to increase the price by Percentage or Fixed rate.
      3. In the text box, enter the value to increase the price by.
    • (Variants only) To define a new price, irrespective of the current price, select a new price, and then enter the new price.
      tip

      The Preview of Adjustment section shows the current price alongside a preview of what the new price will be for variant price adjustments. Because pricing is defined at the variant level, an example price of $100 is used for product type and product price adjustments.

  7. Select Add adjustment.

Remove a price adjustment​

  1. Go to the price book to which you want to remove a price adjustment.
  2. Under Price adjustment, select the trash icon beside a price adjustment to remove it from the price book.

Manage customers in a price book​

When you assign a customer to a price book, they will receive the price adjustments that you define in the price book.

Before you add a customer to a price book, make sure their customer account exists.

note

A customer can only be part of one price book at a time.

Add a customer​

  1. Go to the price book to which you want to add customers.
  2. Open the Customers tab.
  3. In the upper right corner of the table, select Add customer.
  4. Use the search bar to find an select a customer.
  5. Select Add.

Remove a customer​

  1. Go to the price book to which you want to remove customers.
  2. Open the Customers tab.
  3. Select the trash icon beside a customer to remove them from the price book.

Make a price book inactive​

To make a price book inactive, remove all price adjustments. This way, you can keep the group of customers while turning off the price adjustments.

Visit the Catalog -> Price books page and refer to the In Use? field to view whether a price book is active or not.

Delete a price book​

  1. Go to Catalog -> Price books.
  2. Select one or more price books.
  3. Select Delete.

View deleted price books​

Deleted price books are retained for auditing purposes.

View deleted price books on the Catalog -> Price books page. You can filter the Deleted column to find deleted price books.

Was this page helpful?