---
title: PricingPercentageValue - Storefront API
description: >
  A percentage discount value applied to cart items or orders. Returned as part
  of the [`PricingValue`](/docs/api/storefront/2026-01/unions/PricingValue)
  union on [discount
  applications](/docs/api/storefront/2026-01/interfaces/DiscountApplication),
  where it represents discounts calculated as a percentage off rather than a
  [fixed amount](/docs/api/storefront/2026-01/objects/MoneyV2).
api_version: 2026-01
api_name: storefront
type: object
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/storefront/latest/objects/PricingPercentageValue
  md: >-
    https://shopify.dev/docs/api/storefront/latest/objects/PricingPercentageValue.md
---

# Pricing​Percentage​Value

object

A percentage discount value applied to cart items or orders. Returned as part of the [`PricingValue`](https://shopify.dev/docs/api/storefront/2026-01/unions/PricingValue) union on [discount applications](https://shopify.dev/docs/api/storefront/2026-01/interfaces/DiscountApplication), where it represents discounts calculated as a percentage off rather than a [fixed amount](https://shopify.dev/docs/api/storefront/2026-01/objects/MoneyV2).

## Fields

* percentage

  [Float!](https://shopify.dev/docs/api/storefront/latest/scalars/Float)

  non-null

  The percentage value of the object.

***

## Map

### Possible type in

* [Pricing​Value](https://shopify.dev/docs/api/storefront/latest/unions/PricingValue)