Reserved Fields (API)

Reserved Fields are a list of Bloomreach reserved keywords used in feed processing to assign attributes like price, availability, size, etc. using a set terminology. These are consumed by Bloomreach to create a basic understanding of your product catalog and how to process it within the scope of the Bloomreach algorithm. For example, the “price” field is a Reserved Field and must be used to send the details of the price of your product to Bloomreach. If you use a custom field with variations like “my_price” or “product_price” etc. Bloomreach will not treat it as the price of the product.

Reserved Fields are reserved keywords/attributes/fields that cannot be used externally for any field mapping. For example, the field "sale_price" is used to capture price of a product on sale. In Dev Studio, mapping an external dynamic attribute to "sale_price" does not work.

Mandatory fields

There are 8 mandatory Reserved Fields that must be sent to Bloomreach during feed processing. The current list of mandatory Reserved Fields are:

title
category_paths
price
description
url
availability
brand
thumb_image

Reserved object names

There are 5 reserved object names that are used in the product record JSON, which should be avoided as attribute names:

op
path
views
variants
attributes

Using Reserved Fields

While using the reserved fields for building any of the front end components, note details like Data Type, Facetable to use them correctly. For example, the Reserved Field “price” is a number, and trying to filter it as a string returns an error in the API response as it is not supported in the API.

S.no.	Reserved Fields	Required	Data Type	Facetable	Displayable	Field Type (Single/Multivalued)	Returned in API response as
1	availability	Yes	Boolean	No	No	Single	Not returned in API response
2	best_seller	No	Number	No	Can be fetched as FL (stored, indexed field)	Single	Same as reserved field name
3	brand	No	Text	Yes	Yes	Single	Same as reserved field name
4	bundle_id	No	Text	No	Unstored, indexed field	Multivalued	Same as reserved field name
5	capacity	No	Number	No	No	Single	Same as reserved field name
6	category_paths	Yes	Text	Yes	No	Multivalued	category (Note: Category_paths is returned as the category)
7	color	No	Text	Yes	Yes	Single	colors
8	color_group	No	Text	Yes	Yes	Single	color_groups
9	depth	No	Number	No	No	Single	Same as reserved field name
10	description	Yes	Text	No	Yes	Single	Same as reserved field name
11	flag	No	Boolean	No			Same as reserved field name
12	gender	No	Text	Yes	Yes	Single	Same as reserved field name
13	google_category	No		No			Same as reserved field name
14	height	No	Number	No	No	Single	Same as reserved field name
15	is_sellable	No	Boolean	No	Indexed, unstored field	Single	Same as reserved field name
16	item_no	No	Text	No	No	Multivalued	Same as reserved field name
17	keywords	No	Text	No	No	Multivalued	Same as reserved field name
18	large_image	No	Text	Yes	Yes	Multivalued	Same as reserved field name
19	launch_date	No	Text	No	Yes	Single	Same as reserved field name
20	leaf_categories	No	Text	No		Multivalued	Same as reserved field name
21	model_name	No	Text	No	No	Single	Same as reserved field name
22	model_no	No	Text	No	No	Multivalued	Same as reserved field name
23	price	Yes	Number	Yes	Yes	Single	Same as reserved field name
24	promotion	No	Text	No	Yes	Multivalued	Same as reserved field name
25	reviews	No	Number	No	No	Single	Not returned in API response
26	sale_price	No	Number	Yes	Yes	Single	sale_price
27	size	No	Text	Yes	Yes	Single	sizes
28	skuid	No	Text	No	Yes	Single	Same as reserved field name
29	start_date	No	Text	No	Yes	Single	Same as reserved field name
30	stock_level	No	Text	No	No	Multivalued	Same as reserved field name
31	store_id	No	Text	No	Indexed not stored	Multivalued	Same as reserved field name
32	thumb_image	Yes	Text	Yes	Yes	Single	Same as reserved field name
33	title	Yes	Text	No	Yes	Single	Same as reserved field name
34	url	Yes	Text	No	Yes	Single	Same as reserved field name
35	width	No	Number	No	No	Single	Same as reserved field name