Skip to content

Setting up contract price books

Give a customer negotiated prices on top of a standard price book, storing only what differs and inheriting everything else from the parent.

This feature requires an Enterprise plan.

A contract price book holds one customer’s negotiated pricing on top of a regular price book, its parent. It stores only what differs from the parent: a few overridden prices, products the customer can’t buy, and products the parent doesn’t carry. Everything else is inherited live from the parent, so when you change a price in the parent, every contract price book built on it picks up the change automatically.

Contract price books are listed as Contract: {name} everywhere price books appear: the Studio Price Books list, the Quote Builder price book picker, Set Price Book rule outcomes, and the HubSpot price book properties.

A contract price book is not related to HubSpot Contracts. On a change or renewal quote, Quotivity can reuse the HubSpot contract’s price book; that is a separate feature — see Understanding contracts in Quotivity.

  • Use a contract price book when a customer’s pricing should follow your standard catalog except for a handful of negotiated differences. Changes to the parent’s prices, products, and settings flow through without any work on the contract price book.
  • Clone a price book when you want an independent copy — a new fiscal-year list or a regional catalog — that should not change when the original does. See Cloning a Price Book.

A contract price book has exactly one parent, and the parent must be a regular price book. You can’t build a contract price book on top of another contract price book, and a bundle option’s price book can’t be a contract price book.

How a contract price book prices a product

Section titled “How a contract price book prices a product”

Quotivity checks each product, and each currency, separately:

On the contract price book What the quote uses
Nothing set for the product The parent’s pricing, in every currency
An override in some currencies The override in those currencies; the parent’s pricing in the others
Excluded The product isn’t available on this book, in any currency
A product the parent doesn’t include The HubSpot price, unless you override it

An override can use any Override By type your plan includes — Amount, Percent, Volume, Pricing Table, Product Variant, or Cost Plus. It is always measured against the product’s HubSpot price, not against the parent’s price. A 10% decrease on a contract price book is 10% off the HubSpot price, even if the parent already discounts that product.

Entry settings — Allow unit price editing, a calculated price override, and a product variant template — are also inherited unless you set them on the contract price book.

  • A regular price book to use as the parent — see Creating a Price Book
  • An Admin role in Quotivity Studio
  1. Open the parent price book. From the Quotivity Studio sidebar, go to Pricing → Price Books and open the regular price book the customer’s pricing is based on.
  2. Choose Create Contract Price Book. Open the Actions menu and select Create Contract Price Book. The Add Contract Price Book screen opens with that book as the parent.
  3. Name it. Give it a Price Book Name, usually the customer’s name. It will be shown as Contract: {name}.
  4. Set effective dates, if needed. Leave the dates blank to follow the parent’s dates. See Effective dates below.
  5. Save. Click Create Contract Price Book.
  6. Adjust the products. On the Products & Prices tab, every product in the parent is already listed. Override the prices the customer negotiated, exclude products they can’t buy, and add products the parent doesn’t carry.

The products grid shows where each price comes from:

  • Contract Override — this currency’s price is set on the contract price book.
  • Inherited — the price (or a setting such as unit price editing) comes from the parent.
  • Contract only — the product was added to this book and isn’t in the parent.
  • Excluded — the product isn’t available on this book. Its prices show “—”.

The price book details screen also shows a grey box with the parent, the parent’s effective dates, when the contract price book itself is effective, and the companies assigned to it.

Overriding, excluding, and adding products

Section titled “Overriding, excluding, and adding products”
  • Override a price. Select a product and click Override Prices, then set the price for the currencies the customer negotiated. Currencies you leave alone keep inheriting from the parent. In the price dialog, Reset to parent price removes the override so that currency inherits again.
  • Exclude a product. Hover a row the parent includes and click Exclude. The product is removed from this book in every currency, while it stays in the parent. Click Restore to bring it back; if nothing else is set for it on the contract price book, it inherits the parent’s pricing again.
  • Add a product the parent doesn’t have. Click Add Products. The drawer offers only products that aren’t already in the parent. An added product is marked Contract only and priced at its HubSpot price until you override it. Hover the row and click Remove to take it off the book.
  • See only what this book changes. Check Show overrides only next to the search box to list just the products this contract price book sets itself: overridden prices or settings, Contract only products, and excluded products. Products that inherit everything from the parent are hidden until you uncheck it.

If you already keep a full copy of your catalog for a customer, convert it instead of rebuilding it. Converting never changes what the customer can buy or what they pay: the book keeps its products and prices, and products in the parent that the book didn’t have are excluded. Restore any you want to offer.

  1. Open the price book you want to convert.
  2. Choose Convert to Contract Price Book from the Actions menu.
  3. Pick the parent. Choose an active, regular price book and click Convert.

Quotivity compares the book with the parent, product by product and currency by currency:

  • Prices that match the parent are removed, so they inherit from now on.
  • Prices that differ are kept as overrides, per currency.
  • A currency the parent adjusts but this book left at the HubSpot price is kept as an override at 100%, so the price doesn’t change.
  • Products that aren’t in the parent stay on the book as additions.
  • Products in the parent that the book didn’t have are excluded. Restore any you want to offer, and it inherits the parent’s price.

Large books (more than 500 changed rows) convert in the background. The book shows Converting… and can’t be edited until it’s done.

You can’t change the parent after converting. A price book that already has contract price books, a contract price book, and a bundle option’s price book can’t be converted. Convert to Contract Price Book only appears on regular price books that have no contract price books.

Assigning a contract price book to a customer

Section titled “Assigning a contract price book to a customer”

Assign the contract price book on the customer’s HubSpot company record, the same way you assign any price book to a company — see Assigning price books to companies. The company’s Price Book property lists it as Contract: {name}.

The contract price book’s details screen lists the companies assigned to it. That list is read-only; change assignments on the company record.

You can also select a contract price book with a Set Price Book rule. On a new quote, the Select Price Book panel in Quote Builder doesn’t list contract price books, so a contract price book reaches a new quote through a company or deal assignment or a rule. On a quote that already has a price book, a rep can switch to a contract price book with Change Price Book when the price book isn’t locked. See Setting a price book with a rule. A matching rule wins over a company or deal assignment, so if you assign contract price books to companies, add Company → Price Book is not known and Deal → Price Book is not known to your broader Set Price Book rules — see Keep a company’s or deal’s assigned price book.

Building contract price books from accepted quotes

Section titled “Building contract price books from accepted quotes”

Quotivity can keep a customer’s contract price book up to date from the quotes they accept. Turn on Create or update a contract price book when a quote is accepted or signed in Quotivity Studio → Settings → Quoting → Contracts. It is off by default and needs contract price books and company-assigned price books (both Enterprise). It works whether or not Quotivity creates HubSpot contracts.

When a quote is accepted or signed, Quotivity looks at its discounted lines: lines whose net unit price, after the line discount, is below their list price. Each one becomes a Fixed price for that product, in the quote’s currency, on the company’s contract price book. Other currencies keep inheriting. If the company has no contract price book, Quotivity creates one under the quote’s price book, named after the company (it appears as Contract: {company name}), and assigns it to the company. A name already in use gets a number, such as Acme Corp (2).

These lines never write a price:

  • Lines that aren’t discounted
  • Optional lines
  • Products with Exclude from Contract Price Books checked (use it for lines such as sales tax)
  • Lines priced by a calculated price
  • Members of a bundle that uses bundle pricing. They’re priced from each option’s own price book, so they may not be in the quote’s price book at all. Bundle headers, and members of a dynamic pricing bundle, are written.

If the same product is on the quote more than once, a line added on its own wins over a bundle member; otherwise the first line wins.

A quote already on a contract price book doesn’t change the prices that book negotiated. Only discounted lines that the book priced from its parent, or at the HubSpot price for a product not in the parent, are added.

Fixed prices replace tiers. Quotivity always writes one fixed price. If the parent prices a product with volume tiers or a pricing table, the contract price book now charges the quoted price at every quantity for that currency. Review those products after the first accepted quote.

If the update fails, the quote is still accepted, and Quotivity adds a task on the deal: Quotivity contract price book update failed.

A contract price book applies only where its own effective dates and its parent’s effective dates overlap.

  • Leave the contract price book’s dates blank to follow the parent’s dates.
  • Set its own dates to narrow the window — for example, to the term of the customer’s agreement.
  • If the parent expires, the contract price book stops applying too, even if its own dates are still open.

Outside that window the contract price book is skipped like any other expired price book: it isn’t offered in Quote Builder, and price book resolution moves on to the next source. The Price Books list shows the parent’s effective dates on contract price book rows. See Setting price book effective dates.

Inherited prices, products, and settings are read from the parent every time a product is priced. When you change the parent:

  • A new price in the parent reaches every contract price book that hasn’t overridden that product and currency.
  • A product you add to the parent becomes available on its contract price books.
  • A product you remove from the parent is no longer inherited. It stays on a contract price book only if that book has its own override or setting for it, and is then marked Contract only. Currencies without an override fall back to the HubSpot price.

Line items already on a quote keep their price until the quote is re-priced — for example, when the rep changes the price book or clones the quote. Published quotes are not rewritten.

  • Cloning a contract price book creates another contract price book with the same parent. Cloning a parent does not clone its contract price books.
  • Deleting a contract price book works like deleting any price book. A price book that has contract price books can’t be deleted: the Can’t Delete This Price Book dialog lists them. Delete those first.

Contract price books use the same CSV file as other price books — see Price book import file format. The differences:

  • Export writes only the contract price book’s own rows: its overrides and added products. Each excluded product is a row whose operation is exclude, with no model or prices. Inherited prices are not exported, so a re-import never turns them into overrides.
  • On an upsert row, a blank or - currency cell means that currency inherits from the parent. To pin a currency at the HubSpot price when the parent adjusts it, use percent with 1.
  • The operation exclude excludes a product; restore brings it back. An upsert row never restores an excluded product, and it keeps an existing calculated price override the file doesn’t mention.

Line items priced from a contract price book record where their price came from in the Price Source (quotivity_price_source) line item property:

Value Meaning
Contract Override (CONTRACT_OVERRIDE) The contract price book’s own price for that currency
Inherited (INHERITED) The parent’s price
Not in Parent (NOT_IN_PARENT) A product added to the contract price book

Line items priced from a regular price book leave it blank. Use it in HubSpot reports to see how much of a customer’s quote follows the standard catalog. See Quotivity custom properties.

Contract price books are included on Enterprise and Trial. Assigning one to a company also needs company-assigned price books, which are on the same plans.

If an account moves to a plan without contract price books, existing contract price books keep pricing quotes so live quotes aren’t re-priced. Creating, converting, and excluding products need the plan again.

Contract price books can also be managed through the Public API. See the API reference.

Acme negotiated 15% off your Platform license and doesn’t buy your Legacy Add-on, but everything else follows your North America list. Open North America, choose Create Contract Price Book, and name it “Acme”. Override Platform with a 15% Percent Decrease in USD, exclude Legacy Add-on, and assign Contract: Acme on Acme’s company record. When you raise North America prices next year, Acme’s quotes pick up the new prices for everything except Platform.

  • Keep one parent per pricing family (for example, one per region) and build each customer’s contract price book on the parent their pricing follows.
  • Overrides are measured against the HubSpot price. If a customer’s discount is meant to stack on the parent’s discount, set the combined value.
  • Set effective dates on the contract price book to match the customer’s agreement, so it stops applying when the agreement ends.