# Price types

> Price types allow you to define multiple categories of price for an individual item in a cart item catalog. This allows you to implement targeted pricing for specific customer segments.

> For the complete documentation index, see [llms.txt](https://docs.talon.one/llms.txt).

<FeatureAccessInfoBox>
Only admins have access to this feature.
</FeatureAccessInfoBox>

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.

Price types work in conjunction with [price adjustments](/docs/dev/integration-guides/set-up-price-types#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, you [programmatically
update a cart item catalog](/integration-api#tag/Catalogs/operation/syncCatalog) connected to an Application to provide
the price adjustment for the item.

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.

:::tip
For more detailed information about
price adjustments, setting up your integration to use price types, and payload examples,
see the related [developer docs](/docs/dev/integration-guides/set-up-price-types) page.
:::

### 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, 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).

Sync the catalog again 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 name="Price Type" type="builtin" />
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:

`(`<Attribute name="Item.Price" type="builtin" /> `* 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.

## Create a price type

Before creating a price type, ensure that you have created a cart item catalog
and connected it to your Application.

To create a price type:

1. On the leftmost menu, click <Account className="icon"/> **Account**,
   then click <Tools className="icon"/> **Tools** > **Price Types**.
1. In the top-right corner of the page, click **Create Price Type**.
1. In **Name**, type the name of the price. This is the name that you
   see in the Rule Builder.
1. In **API name**, type an identifier for the price type. This is used for
   integration purposes.
   :::note
   You cannot use the following reserved names for the price type **Name** or
   **API name**:

   - `base`: Refers to the `base` price value in the catalog, which is the regular
     price of the item.
   - `custom`: Refers to the price type sent in the response when a [customer session is
     updated](/integration-api#tag/Customer-sessions/operation/updateCustomerSessionV2).
   :::
1. (Optional) In **Description**, type a description for the price type.
1. (Optional) In **Audience**, select one or more audiences to limit the price type to. If
   you select none, the price type can be used for all audiences.
1. Click **Create Price Type**.

:::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.
:::

## Edit a price type

To edit a price type:

1. On the leftmost menu, click <Account className="icon"/> **Account** > <Tools className="icon"/> **Tools** > **Price Types**.
1. To the right of the price type you want to edit, click <Edit className="icon"/>.
1. Edit the name, description, or connected audiences.
1. Click **Save**.

## Delete a price type

To delete a price type:

1. On the leftmost menu, click <Account className="icon"/> **Account** > <Tools className="icon"/> **Tools** > **Price Types**.
1. To the right of the price type you want to delete, click <Delete className="icon"/>.
1. In the confirmation window that appears, confirm your action and click
   **Delete Price Type**.

## 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)