Product Field Descriptions

Bronto provides predefined fields that you can use to map you product data. These fields are based on Google's Product Feed Specification, so if you use Google product feeds you should be able to easily map your data to these fields.

Field Name Description Rules
Age Group Target age group for the product.

Example: adult

Data Type: String

Max Length: 50 characters

Availability Availability status of the product.

Example: in stock

Data Type: String

Max Length: 100 character

Availability Date Date a pre-order product will be available.

Example: 2015-06-01T12:00-0800

Data Type: Date; must follow ISO 8601 standard

Average Rating Current average rating of the product.

Example: 4.25

Data Type: Double

Brand Brand of the product.

Example: Brand X

Data Type: String

Max Length: 70 characters

Color Color of the product.

Example: red/black

Data Type: String

Max Length: 100 characters

Condition Description of the condition of the product.

Example: new

Data Type: String

Max Length: 100 characters

Description Description of the product.

Example: Red and black plaid cotton skirt

Data Type: String

Max Length: 5000 characters

Gender Target gender for the product.

Example: female

Data Type: String

Max Length: 50 characters

GTIN The global trade item number.

Example: 1234567891234

Data Type: String

Max Length: 50 characters

Image URL URL for the main image for the product.

Example: https://www.mystore.com/images/SKT_REDBLACK_12345.jpg

Data Type: URL

Max Length: 2000 characters

Images are not stored within Bronto, so the feed can only pass URLs referencing images on an external website. If you want to use different image sizes, you will need to need to create additional image fields and pass each image URL in the product data feed that is mapped to those image fields.

Fields with a URL data type must begin with http:// or https:// or the record will not be saved and an error will be logged

Inventory Threshold A product-specific minimum quantity level a product should meet in order for it to be promoted.

Example: 50

Data Type: Double
ISBN The international standard book number.

Example: 4564564561

Data Type: String

Max Length: 100 characters

Margin Gross margin percentage of the product.

Example: 0.427

Data Type: Double

Mobile URL URL representing the mobile product page on the merchant’s website.

Example: https://m.mystore.com/SKT_REDBLACK_12345.asp

Data Type: URL

Max Length: 2000 characters

Fields with a URL data type must begin with http:// or https:// or the record will not be saved and an error will be logged

MPN The manufacturer part number.

Example: ABC123

Data Type: String

Max Length: 70 characters

Parent Product ID Identifier used to group variants of the same product. The parent product ID should match the Product ID for the product in your catalog that is the parent to this group of product variants.

When a product is used as a parent product that product should not have a Parent Product ID.

Example: SKT_001

Data Type: String

Max Length: 100 characters

Price List price of the product.

Example: 29.99 USD

Data Type: Currency

Bronto only supports one currency type per feed, so we do not save the currency type. In the example, Bronto imports 29.99, but not USD.

Product Blacklist Comma separated list of product ID that Recommendations Premium can use as an exclusion list.

Example: product1, product2, product3

Data Type: Product List

The maximum length is 10,000 characters.

Product Category Most relevant category of the product. Typically mapped to Google's Google Product Category field.

Example: Apparel and Accessories > Clothing > Skirts

Data Type: String

Max Length: 750 characters

Product Category should only be mapped to a product attribute that has a single category.

Product ID Unique identifier for the product. This is the ID that is sent to Bronto for products that have been ordered or placed in a cart.

Example: SKT_BLACKWHITE_12345

Note: Product IDs are case sensitive. If a file contains two Product IDs that are identical except for capitalization differences, both are imported as separate products.
When you have a group of products that are variants of a parent product, the Product ID for the parent product should be provided as the Parent Product ID for the other products. The product that is the parent product should not have a Parent Product ID of its own.

Data Type: String

Max Length: 50 characters

Product Type Multi A delimited list of product categories for the product.

Example: Apparel and Accessories > Clothing > Shoes, Apparel and Accessories > Clothing > Sneakers, Apparel and Accessories > Clothing > Footwear

Data Type: Multi

Max Length: 750 characters

Product URL URL representing the product page on the merchant's website.

Example: https://www.mystore.com/SKT_REDBLK_12345.asp

Data Type: URL

Max Length: 2000 characters

Fields with a URL data type must begin with http:// or https:// or the record will not be saved and an error will be logged.

Product Whitelist Comma separated list of product ID that Recommendations Premium can use as an inclusion list to limit recommendation results.

Example: product1, product2, product3

Data Type: Product List

The maximum length is 10,000 characters.

Quantity Current in-stock quantity of the product.

Example: 52

Data Type: Long

Review Count Current number of reviews of the product.

Example: 12

Data Type: Integer

Sale Price Sale price of the product.

Example: 23.99 USD

Data Type: Currency

Bronto only supports one currency type per feed, so we do not save the currency type. In the example, Bronto imports 23.99, but not USD.

Sale Price Effective Start Date The date and time the sale starts.

Example: 2015-06-01T12:00-0800

Data Type: Date

The date format must meet ISO 8601 standards.

Sale Price Effective End Date The date and time the sale ends.

Example: 2015-06-01T12:00-0800

Data Type: Date

The date format must meet ISO 8601 standards.

Size Size of the product.

Example: M

Data Type: String

Max Length: 100 characters

Title Title of the product.

Example: Women's Plaid Skirt

Data Type: String

Max Length: 150 characters

UPC The universal product code.

Example: 789456123789

Data Type: String

Max Length: 100 characters