Clarity product catalog data

A well-structured product catalog improves Clarity’s performance. This article explains how to format and enrich your data for better results.

Why product catalog quality matters

Your product catalog is Clarity’s main source of information. Clarity refers to catalog data to generate relevant responses when customers have questions about your products.

Prepare catalog structure

Format and import the attributes into your product catalog using the Engagement catalog import process. We recommend using consistent and descriptive attribute names. Use the below format as a general guide.

Required attributes

Attribute	Type	Description
`item_id`	string	Unique identifier of the product variant or SKU.
`title`	string	Product name.
`url`	string	Direct URL of the product.
`image`	string	URL of the main product image.
`price`	float	The final product price, including any active discounts.

Recommended attributes

Attribute	Type	Description
`description`	string	Detailed description of the product. The description field is crucial and should contain all necessary information that a salesperson would use to sell the product. This guides how Clarity responds to inquiries about the products.

Optional but recommended attributes

Attribute	Type	Description
`brand`	string	Product brand.
`active`	boolean	Shows if the product is available on your site. Options: true/false, 0/1
`product_id`	string	Product identifier, not considering sizes, colors, and so on. Variants of the same product (for example, different colors or sizes) share a `product_id` but have unique `item_id` values.
`stock_level`	integer	URL of the main product image.
`original_price`	float	The final product price, including any active discounts.

Update the catalog data using catalog configuration.

How to improve product catalog quality

Mandatory requirements

Include all the required attributes to ensure product data accuracy.

Product catalog best practices

The attribute names must be clear and descriptive.
Attribute values should match the language of the Clarity Agent. All data must be in the same language.
Add all the recommended attributes to your catalog.
Write detailed product descriptions. Clarity relies on the product description to craft engaging responses. Include key selling points.
Add other attributes relevant to your specific product domain. If you sell home appliances, consider adding attributes like energy_efficiency and noise_level.
Update your product catalog data daily to ensure accurate pricing and stock levels. For active products on your website, update the current price and stock information as often as possible.