Configure schema and searchable attributes

Configure the general catalog schema to define how records transform into items. This guide helps you map your source record fields to custom item attributes.

To configure the schema for your product catalog, use Item collections.

How schema changes work

Modifying a catalog's schema immediately triggers a reprocessing of all existing records, resulting in a complete regeneration of items based on the new schema. This action can have immediate and significant effects on application usage.

For example, changing the data type of an attribute used in a campaign or recommendation may cause those campaigns to behave unexpectedly or fail.

Always test schema changes in a non-production environment to prevent unexpected issues in dependent applications.

Configure attributes

1. Go to Schema > Custom attributes tab.

2. To create a new custom attribute, click + Add custom attribute.

3. Enter an attribute name. For example: blog_title.

4. Enter the record field name as the source field of this attribute.

5. Choose the data type of the attribute. For example, String, Integer, Boolean, and more.

6. Toggle ON the Searchable switch to enable searching and filtering using this attribute. There is a limit of 40 searchable attributes per catalog.

   

7. Click Save changes.

The system uses the schema to process data and generate items.