# Manage cart item catalogs

> Cart item catalogs allow you to synchronize your entire inventory with Talon.One, making it easier to create item-based campaigns.

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

<FeatureAccessInfoBox>
Only admins have full access to this feature. Application admins can only view cart item catalogs connected to Applications of which they are an admin.
</FeatureAccessInfoBox>

Each item in a cart item catalog has three [built-in attributes](/docs/dev/concepts/attributes.md#built-in-attributes):
- **Product**: Product the item belongs to. This is an optional attribute. A product
  is a group of SKUs.
- **SKU**: Stock keeping unit of the item in the catalog. This is a mandatory
  attribute. Each cart item in the catalog must have a unique SKU.
- **Price**: Price of the item. This is an optional attribute.

### Group SKUs as products

Grouping SKUs with similar properties as products enhances their visibility and
identification. It also enables you to aggregate your data. If an SKU is not
grouped, you can group it by adding the product attribute to the item with that SKU in
a catalog programmatically using the [Sync cart item catalog](/integration-api#tag/Catalogs/operation/syncCatalog)
endpoint.

You can also ungroup an SKU by removing the product attribute from an item in
the catalog using the same endpoint.

### Add custom attributes

As well as [grouping SKUs as products](#group-skus-as-products), you can add
[custom attributes][attrib] with associated entity **cart item** to your catalog. These
custom cart item attributes provide additional information such as the location or size
of each item. They also allow you to filter the items in your catalog when editing or
removing them [programmatically](/integration-api#tag/Catalogs/operation/syncCatalog).

The following are then available as [picklist values](/docs/product/account/dev-tools/manage-attributes.md#catalog-based-picklist-values)
in all the Applications connected to the catalog:
- The <Attribute name="Product" type="builtin" /> and <Attribute name="SKU of item" type="builtin" />
  built-in attributes of catalog items.
- The values of the catalog's custom cart item attributes with type **string** and
  **list of strings**, for example, <Attribute name="Color of item" type="custom" />.

:::important
- You can connect a maximum of 100 custom cart item attributes to a single catalog.
- For rule evaluation, if built-in and custom cart item attributes are not present in the
  customer session, they are loaded from the cart item catalog connected to the
  Application.
:::

The following example shows you a catalog that has cart items with product, SKU, price,
and other custom attributes:

<CatalogStructure className="figma" width="90%" alt="The catalog structure" />

## Create a cart item catalog

To create a cart item catalog:

1. On the leftmost menu, click <Account className="icon"/> **Account** > <Tools className="icon"/> **Tools** > **Cart Item Catalogs**.
1. At the top right of the page, click <Add className="icon"/> **Create Catalog**.
1. In **Catalog name**, type a name for your catalog.
1. In **Description**, type a description for the catalog.
1. (Optional) In **Connected Applications**, select the Applications you want to connect
   to the catalog. You can also do this later while [editing the catalog](#edit-a-cart-item-catalog).

   :::note
A catalog can be connected to several Applications, but an Application can only be connected
to one catalog. As a result, some Applications may not be available to be selected.

To see a list of cart item catalogs and their connected Applications, click **Existing Connections**.
:::

1. Click **Create Catalog**.

## Considerations when updating a cart item catalog

- A catalog can only be updated programmatically via the [Sync cart item catalog](/integration-api#tag/Catalogs/operation/syncCatalog)  endpoint. You can add, edit, or remove one or more items from your catalog via this
  endpoint.
- When updating a catalog, we recommend you do the following:
  - Sync multiple items in a single request, rather than an individual item.
  - Limit the number of items to 1000 per request.

For more information about best practices and catalog sync actions, see the related
[developer docs](/docs/dev/integration-guides/sync-cic) page.

## List cart item catalogs

On the leftmost menu, click <Account className="icon"/> **Account** > <Tools className="icon"/> **Tools** > **Cart Item Catalogs**.

This page displays all the available cart item catalogs and contains the following information
for each of them:

| Column       | Description                                                                                          |
| ------------ | ---------------------------------------------------------------------------------------------------- |
| Name         | Name of the cart item catalog.                                                                       |
| ID           | Unique number identifying the cart item catalog. It can be used for integration purposes.            |
| Applications | Number of [Applications](/docs/product/applications/overview.md) connected to the cart item catalog. |

## Display a cart item catalog

To view the details and contents of a cart item catalog:

1. On the leftmost menu, click <Account className="icon"/> **Account** > <Tools className="icon"/> **Tools** > **Cart Item Catalogs**.
1. Click the name of the cart item catalog you want to display.

This page displays the following information about the catalog:

- **Catalog name**: Name of the cart item catalog.
- **Catalog ID**: Unique number identifying the cart item catalog. It can be used for
  integration purposes.
- **Connected Applications**: Applications the cart item catalog is connected to.
- **Description**: Description of the cart item catalog.

The page also contains a table with additional information about each item in the catalog:

| Column      | Description                  |
| ----------- | ---------------------------- |
| **Product** | Product the item belongs to. |
| **SKU**     | SKU of the item.             |
| **Price**   | Price of the item.           |

Any other custom [cart item attributes](/docs/product/account/dev-tools/manage-attributes.md) that
you [have connected to this catalog](/docs/product/account/dev-tools/manage-attributes.md#create-a-custom-attribute),
such as brand, weight, or color, also appear in this table as separate columns.

## Edit a cart item catalog

To edit a cart item catalog:

1. On the leftmost menu, click <Account className="icon"/> **Account** > <Tools className="icon"/> **Tools** > **Cart Item Catalogs**.
1. To the right of the catalog you want to edit, click <Edit className="icon"/>.
1. Edit the **Catalog name** or **Description**.
1. In **Connected Applications**, select the Applications that you want to connect
   to or disconnect from your catalog.
1. Click **Save**.

## Delete a cart item catalog <ClosedBetaBadge/>

:::caution
Deleting a cart item catalog permanently deletes the values of its built-in and custom
attributes. This may impact campaigns that reference these attributes. To ensure that your
campaigns are not impacted, remove the referenced attributes before deleting the catalog.
:::

To delete a cart item catalog:

1. On the leftmost menu, click <Account className="icon"/> **Account** > <Tools className="icon"/> **Tools** > **Cart Item Catalogs**.
1. To the right of the catalog you want to delete, click <Delete className="icon"/>.
1. In the pop-up that appears, enter the catalog name and select the checkbox.
1. Click <Delete className="icon"/> **Delete Catalog**.

## List the connected Applications of a catalog

To list the connected Applications of a cart item catalog:

1. On the leftmost menu, click <Account className="icon"/> **Account** > <Tools className="icon"/> **Tools** > **Cart Item Catalogs**.
1. Click the name of the cart item catalog you want to display.
1. In **Connected Applications**, click the number of connected Applications.

## Related pages

- [Manage attributes](/docs/product/account/dev-tools/manage-attributes.md)
- [Applications overview](/docs/product/applications/overview.md)
- [Strikethrough rules][strules]
- [Strikethrough pricing notifications](/docs/product/applications/application-notifications/overview.md#strikethrough-pricing-updates)
- [Sync a cart item catalog](/docs/dev/integration-guides/sync-cic.md)

[strules]: /docs/product/rules/create-and-manage-rules.md#create-a-strikethrough-rule
[attrib]: /docs/product/account/dev-tools/manage-attributes.md#create-a-custom-attribute