Product Class

👍

Data hub rollout

Data hub provides new unified API integration methods for sending data to multiple Bloomreach products. Access is being rolled out in phases. For new implementations, we recommend using Data hub where available. Existing product-specific integrations remain fully supported for Engagement, Discovery, and Clarity.

  • Display Name: Product Class

  • System Name: product_class

  • Data Type: String

  • Levels: Product

  • Used By Apps: All

  • Required By Apps: None

Defines the classification of a product that determines its processing and runtime
behavior.
Accepts an open extensible set of values, with the first two valid values being
simple and complex.

This attribute controls:

  1. How the product is processed during data ingestion

  2. How the product behaves at runtime in applications

  3. Whether the product requires variants to be included in the final item set

Processing Behavior

  • If not set, a product with no variants found during processing is considered a simple
    product and behaves according to simple product application behavior

  • If set to complex and no variants are present during processing, the product will
    not be part of the final set of items built

  • The value controls both processing logic and runtime application behavior

Valid Values

  • simple - Product behaves as a simple product regardless of variant presence

  • complex - Product requires variants and behaves as a complex product

  • Additional values may be supported in the future as the classification system expands

General Usage

  • Managing mixed product catalogs with both simple and complex products

  • Controlling product processing pipeline behavior

  • Determining application-specific runtime behavior

Examples

"simple"
"complex"

Application Specific Usage

Engagement

Reserved Attribute Name: product_class

Used for:

  • When a set of items contains a mix of simple and complex products, each simple product
    will be present as an entry in the Engagement variant catalog alongside the
    denormalized variants

  • Determining catalog structure and product presentation logic

  • Managing unified product experiences across different product types

Discovery

Reserved Attribute Name: product_class

Used for:

  • When a set of items contains a mix of simple and complex products, each simple product
    will have a dummy variant created for it to ensure consistent search functionality

  • Normalizing product data structure for unified search and filtering capabilities

  • Ensuring consistent faceting and filtering behavior across all product types