Discount Percentage

👍
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 Marketing, Search, and Conversational agent.

Display Name: Discount Percentage
System Name: discount_percentage
Data Type: Float
Levels: All
Used By Apps: Engagement
Required By Apps: None

The percentage discount applied to the product or variant, calculated as the percentage
difference between the original price and the current price.

Value must be a float between 0 and 100 (inclusive) representing the percentage off.
Decimal precision is allowed for precise discount calculations.

If the product has variants:

discount_percentage should only be supplied at the variant level for those variants
Product-level discount_percentage will be ignored when variants are present
Each variant should have its own discount_percentage value if applicable

This attribute is typically calculated as: `((original_price - price) / original_price)

100`

Value of 0 indicates no discount.
Values above 100 are not valid as they would indicate a negative final price.

General Usage

Displaying discount badges or promotional messaging on product cards and detail pages
Highlighting sale items with percentage off indicators
Creating dynamic promotional banners based on discount tiers

25.0

33.33

10.5

Application Usage

Marketing

Reserved Attribute Name: discount_percentage

Used for:

Displaying discount badges on product cards and detail pages
Creating dynamic promotional messaging based on discount tiers (e.g., "Up to 50% off")
Triggering promotional campaigns and email notifications for specific discount
thresholds

Search

Not currently used by Search

Search automatically calculates discount percentages when both price and
original_price are provided, so this system attribute is not required for Search
functionality.

Please reference information on Search's discount and discount_percent reserved
attributes.