Discount Percentage

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

Engagement

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

Discovery

Not currently used by Discovery

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

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