# Set up price types
> Use price types to define multiple categories of price for an individual item in a cart item catalog.
> For the complete documentation index, see [llms.txt](https://docs.talon.one/llms.txt).
You can link a price type to one or more [audiences](/docs/product/audiences/overview.md)
to limit its benefit to those audience members only. Multiple price types can be
created in an Application.
Only admins have access to this feature.
## Price adjustments
Price types work in conjunction with **price adjustments**, which are specific price
values assigned to a cart item for a given price type.
After [creating a price type](/docs/product/account/dev-tools/manage-price-types#create-a-price-type)
in the Campaign Manager, [programmatically
update a cart item catalog](/integration-api#tag/Catalogs/operation/syncCatalog) connected to an Application to provide
the price adjustment for the item. You do this by sending the following requests in
this order:
1. The first request adds the item to the catalog using the
`ADD` sync [action type](/integration-api#tag/Catalogs/operation/syncCatalog). You can
send this request before or after you create the price type.
1. The second request assigns the price adjustment for the price type to the item using
the `ADD_PRICE_ADJUSTMENT` sync action type.
For each new price type you create, new custom attributes appear in the Rule Builder:
`Price`, `Adjustment Reference ID`, `Price Adjustment Start Date`, and
`Price Adjustment Expiry Date`. Each attribute corresponds to a property of the selected
price adjustment for that price type. Use [cart item filters](/docs/product/rules/cart-item-filters/overview)
to reference these attributes in your rules.
### Example
Imagine you want to offer an item, for example a shirt, at a special price to customers
who are members. You can create a price type called `membersPrice` and link an audience
that includes members only. Customers who are not members can still purchase the item at
its regular price, which is the `base` price in the catalog.
First, use the `ADD` sync action type to sync a catalog containing the shirt with your
Application. Next, create a price type. After you create the price type, new built-in and
custom attributes become available
for use in [cart item filters](/docs/product/rules/cart-item-filters/overview) and
per-item [effects](/docs/product/rules/effects/overview.md).
Use the `ADD_PRICE_ADJUSTMENT` sync action type to sync the catalog to assign the price
adjustments to the `membersPrice` price type.
Create a new cart item filter named
`shirts` to restrict the discount to items in the customer session that have the
`membersPrice` price type. Use the
attribute to reference the new price type in your rules.
When you apply the [Discount individual items](/docs/product/rules/effects/use-effects.md#discount-individual-items)
effect, select `shirts` as the list of items to discount and enter the following discount
value:
`(` `* 10%)`.
After rule evaluation, members get 10% off the price value assigned to the
`membersPrice` price type for the item. Other customers can purchase the item at its
regular price.
## How it works
When a customer session is updated, Talon.One loads the price types and price adjustments
from the catalog for each cart item and selects a price.
### Price adjustment selection
For each price type, Talon.One selects the most recent, currently active price adjustment.
A price adjustment is currently active when the time of evaluation falls within the time
frame defined by the `effectiveFrom` and `effectiveUntil` parameters.
If no time frame is defined, the price adjustment is always active.
To select a price adjustment, Talon.One checks the time provided in the `calculatedAt`
parameter. If this time is provided, the price adjustment with the most recent
`calculatedAt` value is selected. If it is not provided, the price adjustment that was
most recently synced with the cart item catalog is selected.
If multiple price adjustments were either synced with the catalog or have a `calculatedAt`
parameter with the same time value, Talon.One selects the price adjustment that was
most recently synced.
### Price type selection
If there are multiple price types for an item, Talon.One selects the price
in the following priority order:
1. The price adjustment defined in a customer session request, if provided. Talon.One
only loads the prices for which the customer profile is eligible.
1. The price with the lowest value. If the price types have the same value, Talon.One picks:
1. The base price, if it matches the value of the price types.
1. The price type that was created first, if the base price is higher than the value
of the price types.
The base price refers to the `base` price value in the catalog, which is the regular
price of the item.
:::important
- Price types are linked to all the catalogs in your account.
- If a cart item is removed from a catalog, the price adjustments for the item are deleted.
- If a catalog is deleted, any price adjustments are removed from the deleted catalog.
:::
## Related pages
- [Managing cart item catalogs](/docs/product/account/dev-tools/manage-cart-item-catalogs.md)
- [Cart item filters](/docs/product/rules/cart-item-filters/overview.md)
- [Best prior price](/docs/dev/integration-guides/best-prior-price)
## Payload examples
```json title="Syncing a cart item catalog with a price adjustment"
{
"actions": [
{
"type": "ADD_PRICE_ADJUSTMENT",
"payload": {
"sku": "25july_sku9",
"adjustments": [
{
"priceType": "priceA",
"price": 17.5,
"referenceId": "e6783c30-09f8-4c5a-8107-b58ade5fb5dd",
"effectiveFrom": "2024-08-14T16:18:00+02:00",
"effectiveUntil": "2026-08-14T16:18:00+02:00",
"contextId": "specialSaleId"
},
{
"priceType": "priceB",
"price": 19.8,
"referenceId": "b6a74b34-fb76-46a5-8c1d-07f3e124c69c",
"effectiveFrom": "2024-08-14T16:18:00+02:00",
"effectiveUntil": "2026-08-14T16:18:00+02:00"
}
]
}
},
{
"type": "ADD_PRICE_ADJUSTMENT",
"payload": {
"sku": "25july_sku10",
"adjustments": [
{
"priceType": "priceA",
"price": 27.99,
"referenceId": "8860a9b5-72d4-4bfb-8a9a-775c50623d6a",
"effectiveFrom": "2025-07-25T16:18:00+02:00",
"effectiveUntil": "2025-08-15T16:18:00+02:00",
"contextId": "specialSaleId"
}
]
}
}
]
}
```
```json title="Strikethrough pricing notification for multiple price adjustments"
{
"applicationId": 1,
"currentBatch": 0,
"totalBatches": 1,
"trigger": {
"id": 33,
"type": "NOTIFICATION_SETUP",
"triggeredAt": "2025-07-25T11:58:51.410829Z",
"totalAffectedItems": 7,
"payload": {
"accountId": 1,
"applicationId": 1,
"catalogId": 1,
"catalogVersion": 12
}
},
"changedItems": [
{
"id": 1,
"catalogId": 1,
"sku": "25july_sku1",
"version": 1,
"price": 60.000,
"prices": {
"base": {
"price": 60.000
},
"priceA": {
"price": 25.000,
"adjustmentReferenceId": "25july_sku1-ref1"
},
"priceB": {
"price": 23.000,
"adjustmentReferenceId": "25july_sku1-ref2"
},
"priceC": {
"price": 22.300,
"adjustmentReferenceId": "25july_sku1-ref3"
},
"priceD": {
"price": 35.320,
"adjustmentReferenceId": "25july_sku1-ref4"
}
},
"evaluatedAt": "2025-07-25T11:58:55.034976Z",
"effects": [
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "setDiscountPerItem",
"props": {
"name": "10% off per item",
"value": 2.23
},
"selectedPriceType": "priceC",
"selectedPrice": 22.300,
"adjustmentReferenceId": "25july_sku1-ref3",
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
},
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "customEffectPerItem",
"props": {
"effectId": 1,
"name": "ce_item",
"payload": {
"stringParameterPayload - selected Price": "priceC",
"numberParameterPayload - price value": "22.300"
}
},
"selectedPriceType": "priceC",
"selectedPrice": 22.300,
"adjustmentReferenceId": "25july_sku1-ref3",
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
}
]
},
{
"id": 2,
"catalogId": 1,
"sku": "25july_sku2",
"version": 1,
"price": 0,
"prices": {
"priceA": {
"price": 31.000,
"adjustmentReferenceId": "25july_sku2-ref1"
},
"priceB": {
"price": 30.320,
"adjustmentReferenceId": "25july_sku2-ref4"
},
"priceC": {
"price": 33.000,
"adjustmentReferenceId": "25july_sku2-ref3"
}
},
"evaluatedAt": "2025-07-25T11:58:55.034994Z",
"effects": [
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "setDiscountPerItem",
"props": {
"name": "10% off per item",
"value": 3.032
},
"selectedPriceType": "priceB",
"selectedPrice": 30.320,
"adjustmentReferenceId": "25july_sku2-ref4",
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
},
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "customEffectPerItem",
"props": {
"effectId": 1,
"name": "ce_item",
"payload": {
"stringParameterPayload - selected Price": "priceB",
"numberParameterPayload - price value": "30.320"
}
},
"selectedPriceType": "priceB",
"selectedPrice": 30.320,
"adjustmentReferenceId": "25july_sku2-ref4",
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
}
]
},
{
"id": 3,
"catalogId": 1,
"sku": "25july_sku3",
"version": 1,
"price": 0,
"prices": {
"priceA": {
"price": 130.100,
"adjustmentReferenceId": "25july_sku3-ref1"
},
"priceB": {
"price": 32.500,
"adjustmentReferenceId": "25july_sku3-ref2"
},
"priceC": {
"price": 33.000,
"adjustmentReferenceId": "25july_sku3-ref3"
},
"priceD": {
"price": 12.000,
"adjustmentReferenceId": "25july_sku3-ref4"
}
},
"evaluatedAt": "2025-07-25T11:58:55.035006Z",
"effects": [
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "setDiscountPerItem",
"props": {
"name": "10% off per item",
"value": 3.25
},
"selectedPriceType": "priceB",
"selectedPrice": 32.500,
"adjustmentReferenceId": "25july_sku3-ref2",
"targets": [
{
"type": "NONE"
}
]
},
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "customEffectPerItem",
"props": {
"effectId": 1,
"name": "ce_item",
"payload": {
"stringParameterPayload - selected Price": "priceB",
"numberParameterPayload - price value": "32.500"
}
},
"selectedPriceType": "priceB",
"selectedPrice": 32.500,
"adjustmentReferenceId": "25july_sku3-ref2",
"targets": [
{
"type": "NONE"
}
]
},
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "setDiscountPerItem",
"props": {
"name": "10% off per item",
"value": 1.2
},
"selectedPriceType": "priceD",
"selectedPrice": 12.000,
"adjustmentReferenceId": "25july_sku3-ref4",
"targets": [
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
},
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "customEffectPerItem",
"props": {
"effectId": 1,
"name": "ce_item",
"payload": {
"stringParameterPayload - selected Price": "priceD",
"numberParameterPayload - price value": "12.000"
}
},
"selectedPriceType": "priceD",
"selectedPrice": 12.000,
"adjustmentReferenceId": "25july_sku3-ref4",
"targets": [
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
}
]
},
{
"id": 4,
"catalogId": 1,
"sku": "25july_sku4",
"version": 1,
"price": 55.000,
"prices": {
"base": {
"price": 55.000
},
"priceA": {
"price": 245.000,
"adjustmentReferenceId": "25july_sku4-ref1"
},
"priceB": {
"price": 19.990,
"adjustmentReferenceId": "25july_sku4-ref2"
},
"priceC": {
"price": 122.300,
"adjustmentReferenceId": "25july_sku4-ref3"
},
"priceD": {
"price": 56.000,
"adjustmentReferenceId": "25july_sku4-ref4"
}
},
"evaluatedAt": "2025-07-25T11:58:55.034958Z",
"effects": [
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "setDiscountPerItem",
"props": {
"name": "10% off per item",
"value": 1.999
},
"selectedPriceType": "priceB",
"selectedPrice": 19.990,
"adjustmentReferenceId": "25july_sku4-ref2",
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
},
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "customEffectPerItem",
"props": {
"effectId": 1,
"name": "ce_item",
"payload": {
"stringParameterPayload - selected Price": "priceB",
"numberParameterPayload - price value": "19.990"
}
},
"selectedPriceType": "priceB",
"selectedPrice": 19.990,
"adjustmentReferenceId": "25july_sku4-ref2",
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
}
]
},
{
"id": 5,
"catalogId": 1,
"sku": "25july_sku5",
"version": 1,
"price": 15.000,
"prices": {
"base": {
"price": 15.000
},
"priceC": {
"price": 27.000,
"adjustmentReferenceId": "25july_sku5-ref3",
"adjustmentEffectiveFrom": "2024-07-29T22:00:00Z",
"adjustmentEffectiveUntil": "2026-08-25T07:25:00Z"
},
"priceD": {
"price": 37.000,
"adjustmentReferenceId": "25july_sku5-ref4"
}
},
"evaluatedAt": "2025-07-25T11:58:55.034989Z",
"effects": [
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "setDiscountPerItem",
"props": {
"name": "10% off per item",
"value": 1.5
},
"selectedPriceType": "base",
"selectedPrice": 15.000,
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
},
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "customEffectPerItem",
"props": {
"effectId": 1,
"name": "ce_item",
"payload": {
"stringParameterPayload - selected Price": "base",
"numberParameterPayload - price value": "15.000"
}
},
"selectedPriceType": "base",
"selectedPrice": 15.000,
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
}
]
},
{
"id": 6,
"catalogId": 1,
"sku": "25july_sku6",
"version": 1,
"price": 15.600,
"prices": {
"base": {
"price": 15.600
},
"priceA": {
"price": 11.600,
"adjustmentReferenceId": "25july_sku6-ref1"
},
"priceB": {
"price": 17.600,
"adjustmentReferenceId": "25july_sku6-ref2"
},
"priceC": {
"price": 27.600,
"adjustmentReferenceId": "25july_sku6-ref3"
},
"priceD": {
"price": 37.600,
"adjustmentReferenceId": "25july_sku6-ref4"
}
},
"evaluatedAt": "2025-07-25T11:58:55.035Z",
"effects": [
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "setDiscountPerItem",
"props": {
"name": "10% off per item",
"value": 1.16
},
"selectedPriceType": "priceA",
"selectedPrice": 11.600,
"adjustmentReferenceId": "25july_sku6-ref1",
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
},
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "customEffectPerItem",
"props": {
"effectId": 1,
"name": "ce_item",
"payload": {
"stringParameterPayload - selected Price": "priceA",
"numberParameterPayload - price value": "11.600"
}
},
"selectedPriceType": "priceA",
"selectedPrice": 11.600,
"adjustmentReferenceId": "25july_sku6-ref1",
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
}
]
},
{
"id": 7,
"catalogId": 1,
"sku": "25july_sku7",
"version": 1,
"price": 15.700,
"prices": {
"base": {
"price": 15.700
},
"priceA": {
"price": 11.620,
"adjustmentReferenceId": "25july_sku7-ref9",
"adjustmentEffectiveFrom": "2025-07-24T22:00:00Z",
"adjustmentEffectiveUntil": "2025-07-25T12:00:00Z"
},
"priceB": {
"price": 17.620,
"adjustmentReferenceId": "25july_sku7-ref10",
"adjustmentEffectiveFrom": "2025-07-24T22:00:00Z",
"adjustmentEffectiveUntil": "2025-07-25T12:00:00Z"
},
"priceC": {
"price": 27.620,
"adjustmentReferenceId": "25july_sku7-ref11",
"adjustmentEffectiveFrom": "2025-07-24T22:00:00Z",
"adjustmentEffectiveUntil": "2025-07-25T12:00:00Z"
},
"priceD": {
"price": 37.620,
"adjustmentReferenceId": "25july_sku7-ref12",
"adjustmentEffectiveFrom": "2025-07-24T22:00:00Z",
"adjustmentEffectiveUntil": "2025-07-25T12:00:00Z"
}
},
"evaluatedAt": "2025-07-25T11:58:55.03497Z",
"effects": [
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "setDiscountPerItem",
"props": {
"name": "10% off per item",
"value": 1.162
},
"startTime": "2025-07-24T22:00:00Z",
"endTime": "2025-07-25T12:00:00Z",
"selectedPriceType": "priceA",
"selectedPrice": 11.620,
"adjustmentReferenceId": "25july_sku7-ref9",
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
},
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "customEffectPerItem",
"props": {
"effectId": 1,
"name": "ce_item",
"payload": {
"stringParameterPayload - selected Price": "priceA",
"numberParameterPayload - price value": "11.620"
}
},
"startTime": "2025-07-24T22:00:00Z",
"endTime": "2025-07-25T12:00:00Z",
"selectedPriceType": "priceA",
"selectedPrice": 11.620,
"adjustmentReferenceId": "25july_sku7-ref9",
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
}
]
}
],
"NotificationType": "StrikethroughPrice"
}
```