Promotions

👍

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: Promotions

• System Name: promotions

• Data Type: List.String

• Levels: Product

• Used By Apps: Discovery

• Required By Apps: None

Contains active promotions and relevant keywords for promotional campaigns.

The promotions attribute provides a list of active promotional terms, campaign
identifiers, and sale-related keywords associated with a product.

General Usage

• Search relevance and ranking based on timely promotional messaging

Examples

["black-friday", "50-percent-off", "clearance"]

["summer-sale", "bogo", "free-shipping"]

["flash-sale", "members-only", "limited-time"]

["holiday-special", "new-customer", "bundle-deal"]

Application Usage

Engagement

Reserved Attribute Name: N/A

Promotions attribute is not currently utilized by Engagement application.

Discovery

Reserved Attribute Name: promotions

Used for:

• Search relevance and ranking based on timely promotional messaging

Feature Capabilities & Configuration

• Referenced in Delivery API request parameter as: promotions (as filter query
  parameter)

• Referenced in Delivery API response documents as: promotions

• Can be faceted and filtered on in Delivery APIs?
  YES.

• Available to use in Variant/SKU-select use cases?
  NO.

• Available to use in facet management dashboard?
  NO.

• Searchable by default?

• Facetable by default?

• Displayable by default?