Default Variant

👍

Welcome note

Data hub is our new upgraded platform, which we rolled out in August 2025. It offers a single unified integration for passing your data through to your Bloomreach products.

You have access to Data hub if you've implemented with Bloomreach after August 2025.

Customers who have implemented before August 2025 should follow the existing documentation for Engagement, Discovery, and Clarity.

• Display Name: Default Variant

• System Name: default_variant

• Data Type: Boolean

• Levels: Variant

• Used By Apps: Discovery, Data Hub

• Required By Apps: None

Indicates whether a variant is considered the default or primary variant for a product.
Used in processing logic and application behavior to determine which variant represents
the main product presentation.

Value must be a boolean (true or false). Defaults to false if not specified.

Processing Rules

• Only one variant per product should have default_variant set to true

• If multiple variants have true value, a random variant among those set to true is
  selected as the default

• If no variants are explicitly marked as default, system may apply its own selection
  logic

General Usage

• Determining which variant values to use for product-level attribute inheritance

• Selecting the primary variant for display in product listings

• Establishing processing priorities during Data Hub ingestion

• Hero SKU selection in search and discovery experiences

Examples

true

false

Application Specific Usage

Data Hub

Reserved Attribute Name: default_variant

Used for:

• Item processing logic when one variant is considered primary

• Determining which variant values should populate product-level attributes

• Setting product-level details based on the default variant's values

Discovery

Reserved Attribute Name: default_sku

Used for:

• Hero SKU selection process to determine which variant to display in search results.
  More details on Default
  variant

• Prioritizing variant display in product listings and search pages