Flags

👍

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

• System Name: flags

• Data Type: List.String

• Levels: Product

• Used By Apps: Discovery

• Required By Apps: None

Contains product flags or tags for categorization and filtering.

The flags attribute provides a list of tags or markers that can be applied to products
for various purposes such as merchandising indicators, product attributes, promotional
badges, or internal categorization.
Each flag in the list represents a distinct label or marker that can be used for
filtering, search refinement, or business logic applications.

General Usage

• Product tagging and categorization

• Merchandising badges and indicators

• Promotional and campaign markers

• Internal workflow and status flags

• Multi-value filtering and faceting

Examples

["new-arrival", "sale", "bestseller"]

["eco-friendly", "organic", "sustainable"]

["exclusive", "limited-edition", "clearance"]

["featured", "staff-pick", "trending"]

Application Usage

Engagement

Reserved Attribute Name: N/A

Flags attribute is not currently utilized by Engagement application.

Discovery

Reserved Attribute Name: flags

Used for:

• Multi-value faceting and filtering

• Merchandising rules

• Search refinement and categorization

• Badge and indicator display logic

• Product grouping and collections

The flags attribute in Discovery enables flexible product tagging and categorization.
Products can be filtered by one or more flags, allowing customers to narrow their search
results based on multiple criteria.
Merchandisers can use flags to trigger specific rules, create dynamic collections, or
apply special treatment to flagged products in search results and recommendations.

Feature Capabilities & Configuration

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

• Referenced in Delivery API response documents as: flags

• 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?