---
title: PricingValue - Storefront API
description: The price value (fixed or percentage) for a discount application.
api_version: unstable
api_name: storefront
source_url:
  html: 'https://shopify.dev/docs/api/storefront/unstable/unions/PricingValue'
  md: 'https://shopify.dev/docs/api/storefront/unstable/unions/PricingValue.md'
---

# Pricing​Value

union

The price value (fixed or percentage) for a discount application.

## Possible types

* [Money​V2](https://shopify.dev/docs/api/storefront/unstable/objects/MoneyV2)

  OBJECT

  A precise monetary value with its associated currency. Combines a decimal amount with a three-letter [`CurrencyCode`](https://shopify.dev/docs/api/storefront/unstable/enums/CurrencyCode) to express prices, costs, and other financial values. For example, 12.99 USD.

  * amount

    [Decimal!](https://shopify.dev/docs/api/storefront/unstable/scalars/Decimal)

    non-null

    Decimal money amount.

  * currency​Code

    [Currency​Code!](https://shopify.dev/docs/api/storefront/unstable/enums/CurrencyCode)

    non-null

    Currency of the money.

* [Pricing​Percentage​Value](https://shopify.dev/docs/api/storefront/unstable/objects/PricingPercentageValue)

  OBJECT

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

  * percentage

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

    non-null

    The percentage value of the object.

***

## Fields with this union

* [Automatic​Discount​Application.value](https://shopify.dev/docs/api/storefront/unstable/objects/AutomaticDiscountApplication#field-AutomaticDiscountApplication.fields.value)

  OBJECT

  An [automatic discount](https://help.shopify.com/manual/discounts/discount-methods/automatic-discounts) applied to a cart or checkout without requiring a discount code. Implements the [`DiscountApplication`](https://shopify.dev/docs/api/storefront/current/interfaces/DiscountApplication) interface.

  Includes the discount's title, value, and allocation details that specify how the discount amount distributes across entitled line items or shipping lines.

* [Cart​Discount​Application.value](https://shopify.dev/docs/api/storefront/unstable/objects/CartDiscountApplication#field-CartDiscountApplication.fields.value)

  OBJECT

  Captures the intent of a discount source at the time it was applied to a cart. This includes the discount value, how it's allocated across entitled items, and which line types it targets.

  The actual discounted amounts on specific cart lines are represented by [`CartDiscountAllocation`](https://shopify.dev/docs/api/storefront/current/interfaces/CartDiscountAllocation) objects, which reference this application.

* [Discount​Application.value](https://shopify.dev/docs/api/storefront/unstable/interfaces/DiscountApplication#fields-value)

  INTERFACE

  Captures the intent of a discount at the time it was applied. Each implementation represents a different discount source, such as [automatic discounts](https://help.shopify.com/manual/discounts/discount-methods/automatic-discounts), [discount codes](https://help.shopify.com/manual/discounts/discount-methods/discount-codes), and manual discounts.

  The actual discounted amount on a line item or shipping line is represented by the [`DiscountAllocation`](https://shopify.dev/docs/api/storefront/current/objects/DiscountAllocation) object, which references the discount application it originated from.

* [Discount​Code​Application.value](https://shopify.dev/docs/api/storefront/unstable/objects/DiscountCodeApplication#field-DiscountCodeApplication.fields.value)

  OBJECT

  Records the configuration and intent of a [discount code](https://help.shopify.com/manual/discounts/discount-methods/discount-codes) when a customer applies it. This includes the code string, allocation method, target type, and discount value at the time of application. The [`applicable`](https://shopify.dev/docs/api/storefront/latest/objects/DiscountCodeApplication#field-DiscountCodeApplication.fields.applicable) field indicates whether the code was successfully applied.

  ***

  **Note:** To see the actual amounts discounted on specific line items or shipping lines, use the \<a href="https://shopify.dev/docs/api/storefront/current/objects/DiscountAllocation">\<code>\<span class="PreventFireFoxApplyingGapToWBR">Discount\<wbr/>Allocation\</span>\</code>\</a> object instead.

  ***

* [Manual​Discount​Application.value](https://shopify.dev/docs/api/storefront/unstable/objects/ManualDiscountApplication#field-ManualDiscountApplication.fields.value)

  OBJECT

  A discount created manually by a merchant, as opposed to [automatic discounts](https://help.shopify.com/manual/discounts/discount-methods/automatic-discounts) or [discount codes](https://help.shopify.com/manual/discounts/discount-methods/discount-codes). Implements the [`DiscountApplication`](https://shopify.dev/docs/api/storefront/current/interfaces/DiscountApplication) interface and includes a title, optional description, and the discount value as either a fixed amount or percentage.

* [Script​Discount​Application.value](https://shopify.dev/docs/api/storefront/unstable/objects/ScriptDiscountApplication#field-ScriptDiscountApplication.fields.value)

  OBJECT

  A discount application created by a Shopify Script. Implements the [`DiscountApplication`](https://shopify.dev/docs/api/storefront/current/interfaces/DiscountApplication) interface and captures the discount's value, allocation method, and targeting rules at the time the script applied it.

***

```graphql
union PricingValue = MoneyV2 | PricingPercentageValue
```