---
title: DiscountPercentage - GraphQL Admin
description: |-
  Creates percentage-based discounts that reduce item prices by a specified percentage amount. This gives merchants a flexible way to offer proportional savings that automatically scale with order value.

  For example, a "20% off all winter clothing" promotion would use this object to apply consistent percentage savings across different price points.

  Learn more about [discount types](https://help.shopify.com/manual/discounts/).
api_version: 2025-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/objects/discountpercentage
  md: https://shopify.dev/docs/api/admin-graphql/latest/objects/discountpercentage.md
---

# Discount​Percentage

object

Requires Apps must have `read_discounts` access scope.

Creates percentage-based discounts that reduce item prices by a specified percentage amount. This gives merchants a flexible way to offer proportional savings that automatically scale with order value.

For example, a "20% off all winter clothing" promotion would use this object to apply consistent percentage savings across different price points.

Learn more about [discount types](https://help.shopify.com/manual/discounts/).

## Fields

* percentage

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

  non-null

  The percentage value of the discount.

***

## Map

### Possible type in

* [Discount​Customer​Gets​Value](https://shopify.dev/docs/api/admin-graphql/latest/unions/DiscountCustomerGetsValue)
* [Discount​Effect](https://shopify.dev/docs/api/admin-graphql/latest/unions/DiscountEffect)