> ## Documentation Index > Fetch the complete documentation index at: https://alguna.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Price books > Price lists layered over the product catalog that set prices by currency, quantity tier and deal attributes such as region or customer type, then fill in prices when a rep builds a quote or subscription A **price book** is a price list that sits on top of your [product catalog](https://alguna.com/docs/pricing/configure-products.md). It holds prices for a set of products in one or more currencies. It can change those prices by quantity and by attributes of the deal, such as region or customer type. Use a price book when the same products sell at different prices to different markets or segments, and you want reps to start from approved prices instead of typing them. A typical case is a list price in USD, a derived EUR and GBP price list, and a higher rate for one region. For where prices sit in the object graph, see [How Alguna works](https://alguna.com/docs/concepts/how-alguna-works.md). > [!NOTE] > > Available on request: contact support or your account team to turn it on. It may depend on your plan. Price books are managed in the dashboard, under **Price Books** in the Pricing & Packaging section of the navigation. A quote created through the API can start from a price book; see [Use a price book on a quote or subscription](#use-a-price-book-on-a-quote-or-subscription). *** ## How a price book sets a price A price book works out a price for each product in four steps: 1. **Currency.** It takes the product's price in the currency of the deal. That price is either set directly for the currency or converted from the base currency. 2. **Tier.** It picks the rate tier that matches the quantity. 3. **Multipliers.** It applies every multiplier whose scope matches the product, the currency and the deal's driver values. 4. **Rounding.** For converted prices, it rounds the result if the price book is set to round. The result is a list price and, when one is set, a floor price for the product. *** ## Create a price book On **Price Books**, choose **New Price Book**, enter a **Price Book Name** and choose **Create Price Book**. The price book opens for editing. Its editor has six tabs: **Setup**, **Currencies**, **Drivers**, **Products**, **Pricing** and **Multipliers**. ### Setup Set the price book's name and an optional **Description**. ### Currencies Choose the **Base Currency** and answer **Does this price book support multiple currencies?** | Option | Behavior | | - | - | | **Single Currency** | All prices are in the base currency only. | | **Multi-Currency** | The price book holds prices in more than one currency. | For a multi-currency price book, choose **How should prices be determined for each currency?** | Option | Behavior | | - | - | | **Relative** | Prices in other currencies are calculated from the base currency price using an exchange rate you set on each currency. | | **Explicit** | Prices are set independently for each currency and product. | For **Relative** pricing, you enter the exchange rate for each currency yourself. **How should derived prices be rounded?** offers two options: | Option | Behavior | | - | - | | **No Rounding** | Keeps full precision after conversion. | | **Match Precision** | Rounds each converted price to the same number of decimal places as the base currency price. | Add each extra currency with its **Exchange Rate**. The base currency always has a rate of 1.00. ### Drivers A **driver** is a deal attribute that can change the price, such as region, customer tier or contract length. Choose **Add Driver** and set: | Field | Meaning | | - | - | | **Key** | A short identifier, such as `region`. | | **Label** | The name reps see, such as Geographic Region. | | **Options** | The values a rep can pick, such as EMEA, NA and APAC. Type each option and press Enter. | Drivers have no effect on their own. They decide which multipliers apply. ### Products Choose **Add Product** to add products from your catalog to the price book. Each product is marked **Required** or **Optional**. ### Pricing Pick a product, then a currency, to set its pricing. For each product and currency you set a billing interval (**Monthly**, **Quarterly**, **Semi-Annual** or **Yearly**) and one or more rate tiers. Each tier covers a quantity range and has a **Price** and an optional **Floor** price. When a quantity falls inside a tier's range, that tier's price applies. A quantity above every tier uses the highest tier. In a **Relative** multi-currency price book, the non-base currencies show **Auto-converted from** the base currency, with the exchange rate. Their tiers are read-only. To set prices for one of those currencies by hand, choose **Set Custom**. To go back to converted prices, choose **Use Auto**. A custom price for a currency is used as entered, with no conversion. ### Multipliers A **multiplier** scales the price for the deals it matches. Choose **Add Multiplier** and set: | Field | Meaning | | - | - | | **Name** | A label, such as Enterprise Discount. | | **Multiplier** | The factor applied to the price. `1.10` adds 10%, `0.85` takes off 15%. | | **Priority** | The order in which multipliers are applied, lowest first. | | **Scope** | Which deals the multiplier applies to, by driver value, product or currency. Each condition includes or excludes values. | A multiplier with no scope applies to all products and currencies. A multiplier with several conditions applies only when all of them match. When several multipliers match, each one is applied to the price in turn. A multiplier is also applied to the floor price. *** ## Simulate pricing Open a price book from the **Price Books** list and choose **Simulate Pricing** to test it before reps use it. Choose a currency and driver values, then add products and quantities. The simulator shows the price each product resolves to, its floor, and a calculation trace with the exchange rate and each multiplier applied. Enter an actual price to check it against the floor. A price below the floor is flagged as below the allowable floor. *** ## Use a price book on a quote or subscription When an organization has at least one price book, creating a subscription or quote offers **From a price book**. Pick a price book, then add the products you are selling. The products are priced from the price book in the deal's currency. When the price book has drivers, the builder shows a **Drivers** section with one selector for each driver. Picking a value, such as a region, prices the products again with the multipliers that match. Changing a quantity picks the matching rate tier. Every price stays editable, down to the product's floor price. A price entered below the floor is flagged, and the quote or subscription cannot be saved until the price is at or above the floor. Through the API, [Create a quote](https://alguna.com/docs/api-reference/v2/2026-04-01/quotes/create-a-quote.md) accepts a `price_book_id`, so a blank quote takes its pricing from that price book. It cannot be combined with `plan_id` or `source_subscription_id`. Once a quote or subscription is created, its prices belong to it. Like a [plan](https://alguna.com/docs/pricing/plans.md), a price book is a starting point for building the agreement. The prices the rep confirms are the ones that bill. *** ## Price books, plans and rate cards | Use | When | | - | - | | [Plans](https://alguna.com/docs/pricing/plans.md) | You sell a fixed package of products at set prices. | | Price books | The same products sell at different prices by currency, quantity or deal attributes, and reps price each deal. | | [Rate cards](https://alguna.com/docs/rate-cards/overview.md) | Many metered rates change over time and must update the subscriptions that already use them. | For pricing in several currencies without a price book, see [Multi-currency](https://alguna.com/docs/currencies/multi-currency.md). *** ## FAQ **Does changing a price book change existing subscriptions?** No. A price book sets prices when a quote or subscription is built. Prices already on a quote or subscription stay as they are. **Can a rep go below the floor price?** No. The builder flags any price below the floor, and the quote or subscription cannot be saved until the price is at or above it. **Do multipliers stack?** Yes. Each matching multiplier is applied in priority order, so two multipliers of `1.10` and `0.90` give a factor of `0.99`. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.