As of May 2021, all new integrations are required to use [API based catalog feed management](🔗) to send data and perform index updates.
Each of your products is represented by fields in your product feed. Together these fields describe the product, price, SKU, and similar inventory data. The quick reference table provides a list of most of the fields that you can include in your feed. Some fields are required in your full feed, and these fields are flagged for you in the quick reference table.
Feed Attribute Sync Time
When you add new attributes/categories to the feed, it takes around 1.5 hours for them to reflect on the dashboard. You can add customisations to the new attributes/categories after this sync time.
### Custom fields for Search and Merchandising
You also need to add any custom fields that you want Search and Merchandising to support. Here are some examples:
Advertised promotional text
Sale or clearance flags
Product SKU to enable searches by SKU
Add a column in your feed for each filter, sort, product flag, promotional text, search method, and anything else that needs to be supported. Your Bloomreach representative can help you.
### Custom fields for Insights
You also need to add fields for any business metrics that you want Insights to support. Here are some examples:
On sale percentage
Prices (particularly if your site has multiple price updates throughout the day)
Add a column in your feed for each business metric that needs to be supported. Your Bloomreach representative can help you.
## Quick Reference
This table provides a list of each product feed field and a brief description. Some fields have more complexity than others; scroll to the end of the table for more detailed information, such as extended descriptions and relationships with other fields.
### Help me understand the Required column
An always flag in the Required column indicates that the field is required in your full product feed for all products, regardless of use cases. A use case flag in the Required column indicates that the field is generally optional, but is required for certain use cases. For example, if you have multiple SKUs for a given product in your product catalog, then the skuid field is required for your use case. Your Bloomreach representative can help you determine which fields are required for your specific use cases.
Do you have additional attributes?
If you have additional fields that aren't in this table, then contact your Bloomreach representative to provide information about them. We need to know the names of your additional fields, a brief description of their contents or values, and a description of their role in your product catalog. Example values are helpful.
## SKU fields
Some products have variants, such as different colors and sizes. Each variant of a product has a different SKU from the encompassing product's SKU. Each of these SKUs has its own set of fields. This table has a list of fields that you might need for these SKUs. Use the quick reference table for descriptions and examples.
Some SKU fields also apply to products.
|SKU field||Required for each SKU?||Available for products?|
## Field details
Most of the information that you need for product feed fields is in the quick reference table. Some fields have more complexity than others; these fields have more detailed information, such as extended descriptions and relationships with other fields.
### availability field
The availability field indicates whether or not the product is currently available for sale. You can use an enumerated value or you can use the product's inventory value.
The inventory value is the number of items currently in stock. This number can change frequently.
If you don't want to use the product's inventory for your availability field, then here are the enumerated values:
out of stock
available for order
Your Bloomreach representative can help you decide between the inventory value or an enumerated value.
### thumb_image and large_image fields
The thumb_image field is the URL for a thumbnail image of the product or SKU. The large_image field is the URL or URLs for additional images of the product or SKU. You can have multiple values for the large_image field.
If you have two sizes of the image, then map the smaller size to thumb_image and the larger size to large_image. You can have only one image for thumb_image. Your product must have a thumb_image value, but it doesn't have to have a large_image value.
To specify multiple URL values for large_image, separate each URL with an ASCII character. A pipe (|) character is a common separator. Here's an example:
### crumbs and crumbs_id fields
You must have a crumbs field for each product in your feed. You can also specify a crumbs_id field that maps to the appropriate crumbs field value.
Category Pages and crumbs_ids
To merchandise within the context of a Category, the Category must have an explcit crumbs_id and associated products must be mapped to the crumbs_id in the catalog data feed.
A breadcrumb trail is the series of category and subcategories in a product's taxonomy. Your product feed specifies this trail in the crumbs or crumbs_id attribute. The difference between these fields is crumbs specifies the trail by category name and crumbs_id specifies the trail by category ID.
Both fields accept multiple breadcrumb trails.
To specify a single value, separate each category and subcategory with an ASCII character. A pipe (|) character is a common separator. To specify multiple values, use a different separator. An angle bracket (< or >) character is a common second separator.
Don't use / or & or ; as separators
Don't use forward slash ( / ) or ampersand ( & ) characters because these are reserved characters. Using these reserved characters causes API requests to return a [502 error](🔗).
We also recommend against using semicolon ( ; ) as a separator as it may conflict with our internal feed-config language.
Here are some examples:
|Field||Single value||Multiple values|
Bloomreach reads the category names from the crumbs field and maps them to the corresponding category ID in the crumbs_id field. Here's how the mapping works in the crumbs_id example:
**cat00** maps to Apparel
**cat20** maps to Women
**cat06** maps to Dresses
Each category ID in the crumbs_id field can map to only one category in the crumbs field. For example, cat20 must map only to Women, not to both Women and Dresses.