Discount apps integrate with the Shopify admin to provide discount types for app users. This guide introduces the ways that you can extend your app code into Shopify checkout and customize the discount experience.

- Use the [GraphQL Admin API](#build-with-the-graphql-admin-api) to create and manage [discounts that are native to Shopify](https://help.shopify.com/manual/discounts/discount-types).
- Use [Shopify Functions](#build-with-shopify-functions) to extend your app code into Shopify checkout and create discount functionality that isn't offered out of the box with Shopify.
- Build configuration UIs with [Admin UI extensions](/docs/apps/build/discounts/ux-for-discounts#admin-ui-extensions-vs-remix-app-ui) or [Remix App UI](/docs/apps/build/discounts/ux-for-discounts#admin-ui-extensions-vs-remix-app-ui), to allow merchants to configure the discount functionality in the Shopify admin.

## Build with the GraphQL Admin API

The [GraphQL Admin API](/docs/api/admin-graphql) enables you to create and manage Shopify discounts.

### Discount methods

You can create discounts that are either applied automatically, or applied with discount codes.

The following table describes the different discount methods you can use as part of your app using the GraphQL Admin API:

| Discount method | Description  | Example use cases |
|---|---|---|
| Automatic discount  | A discount that's automatically applied at checkout and on a cart if prerequisites are met.  | - A [Buy X Get Y or Spend X Get Y automatic discount](/docs/api/admin-graphql/latest/mutations/discountAutomaticBxgyCreate)<br/>- A [percentage or fixed-amount automatic discount](/docs/api/admin-graphql/latest/mutations/discountAutomaticBasicCreate) |
| Code discount  | A discount that customers can redeem using a specific code. Merchants can create and share discount codes individually with customers. | - A [Buy X Get Y or Spend X Get Y code discount](/docs/api/admin-graphql/latest/mutations/discountCodeBxgyCreate)<br/>- A [percentage or fixed-amount code discount](/docs/api/admin-graphql/latest/mutations/discountCodeBasicCreate)<br/>- A [free shipping code discount](/docs/api/admin-graphql/latest/mutations/discountCodeFreeShippingCreate) |

Visit the Shopify Help Center to learn about the limitations and considerations that apply to each discount type:

- [Automatic discounts](https://help.shopify.com/manual/discounts/discount-types#automatic-discounts)
- [Code discounts](https://help.shopify.com/manual/discounts/discount-types#considerations-for-creating-discount-codes)

### Access scopes

To use discount-related GraphQL mutations when building with the GraphQL Admin API, your app needs to request the following [access scopes](/docs/api/usage/access-scopes) for a Shopify store:

| Access scope | Required or optional? | Description |
|---|---|---|
| `write_discounts` | Required | Allows apps to create and update Shopify discounts |
| `read_customers` | Optional | Allows apps to query a store's customers |
| `read_products` | Optional | Allows apps to query a store's products |
| `read_shipping` | Optional | Allows apps to query the countries that a store ships to |

## Build with Shopify Functions

[Shopify Functions](/docs/apps/build/functions) enable you to create discount functionality that isn't offered out of the box with Shopify. For example, a discount Function can be used to create a single discount that can reduce the price of a product and shipping rate at once, or volume discounts with different discount rates when a line item quantity meets defined thresholds.

When you create and deploy an app with a Function, you can define a new discount type. After merchants install the app, they can create discounts using these custom discount types. Shopify executes the Function to calculate discounts in real-time when buyers add products to their cart.

![How a developer can create, test, and deploy a Function](/assets/api/functions/create-test-deploy.png)

### How discounts are applied

Shopify's discount system allows for targeted price reductions across different parts of the shopping experience. Discounts can be applied to the following:

- **Cart lines**: Reductions applied to specific products in the cart
- **Order subtotals**: Discounts applied to the entire purchase amount
- **Shipping rates**: Reductions in shipping costs

When you create a Discount, you can specify where the discount should be applied by defining discount classes on a discount instance. These classes determine which part of the cart the discount Function targets, enabling Shopify to correctly calculate and apply the appropriate price reduction during checkout.

### Discount classes



Discount classes are used to define the effect of a discount on a cart. The discount's `discountClasses` field determines which Function targets will be executed during checkout.

App discounts built with the Discount Function API can return operations that use Order and Product discount classes in their [`CartLinesDiscountsGenerateRunResult`](/docs/api/functions/reference/discount/graphql/cartlinesdiscountsgeneraterunresult) and the Shipping class in [`CartDeliveryOptionsDiscountsGenerateRunResult`](/docs/api/functions/reference/discount/graphql/cartdeliveryoptionsdiscountsgeneraterunresult).


| Discount Class | API Target | Description |
|---|---|---|
| Order | [`CartLinesDiscountsGenerateRunResult`](/docs/api/functions/reference/discount/graphql/cartlinesdiscountsgeneraterunresult) | Applies discounts to the entire cart through cart operations |
| Product | [`CartLinesDiscountsGenerateRunResult`](/docs/api/functions/reference/discount/graphql/cartlinesdiscountsgeneraterunresult) | Applies discounts to specific products through cart operations |
| Shipping | [`CartDeliveryOptionsDiscountsGenerateRunResult`](/docs/api/functions/reference/discount/graphql/cartdeliveryoptionsdiscountsgeneraterunresult) | Applies discounts to shipping rates through delivery operations |




## Related mutations and queries

Explore the following resources to manage discounts in your app. Use mutations to craft, modify, and remove discounts, and use queries to retrieve detailed listings.


### Automatic discount mutations

The following table outlines some common mutations for creating, updating, and deleting [automatic](#discount-methods) discounts:

| Discount type |  Mutations |
|---|---|
| Buy X Get Y or Spend X Get Y | [discountAutomaticBxgyCreate](/docs/api/admin-graphql/latest/mutations/discountAutomaticBxgyCreate)<br/>[discountAutomaticBxgyUpdate](/docs/api/admin-graphql/latest/mutations/discountAutomaticBxgyUpdate)<br/>[discountAutomaticDelete](/docs/api/admin-graphql/latest/mutations/discountAutomaticDelete) |
| Percentage or fixed amount | [discountAutomaticBasicCreate](/docs/api/admin-graphql/latest/mutations/discountAutomaticBasicCreate)<br/>[discountAutomaticBasicUpdate](/docs/api/admin-graphql/latest/mutations/discountAutomaticBasicUpdate)<br/>[discountAutomaticDelete](/docs/api/admin-graphql/latest/mutations/discountAutomaticDelete) |
| Free shipping | [discountAutomaticFreeShippingCreate](/docs/api/admin-graphql/latest/mutations/discountAutomaticFreeShippingCreate)<br/>[discountAutomaticFreeShippingUpdate](/docs/api/admin-graphql/latest/mutations/discountAutomaticFreeShippingUpdate)<br/>[discountAutomaticDelete](/docs/api/admin-graphql/latest/mutations/discountAutomaticDelete) |
| App | [discountAutomaticAppCreate](/docs/api/admin-graphql/latest/mutations/discountAutomaticAppCreate)<br/>[discountAutomaticAppUpdate](/docs/api/admin-graphql/latest/mutations/discountAutomaticAppUpdate)<br/>[discountAutomaticDelete](/docs/api/admin-graphql/latest/mutations/discountAutomaticDelete) |

### Code discount mutations

The following table outlines some common mutations for creating, updating, and deleting [code](#discount-methods) discounts:

| Discount type |  Mutations |
|---|---|
| Buy X Get Y or Spend X Get Y | [discountCodeBxgyCreate](/docs/api/admin-graphql/latest/mutations/discountCodeBxgyCreate)<br/>[discountCodeBxgyUpdate](/docs/api/admin-graphql/latest/mutations/discountCodeBxgyUpdate)<br/>[discountCodeDelete](/docs/api/admin-graphql/latest/mutations/discountCodeDelete) |
| Percentage or fixed amount | [discountCodeBasicCreate](/docs/api/admin-graphql/latest/mutations/discountCodeBasicCreate)<br/>[discountCodeBasicUpdate](/docs/api/admin-graphql/latest/mutations/discountCodeBasicUpdate)<br/>[discountCodeDelete](/docs/api/admin-graphql/latest/mutations/discountCodeDelete) |
| Free shipping | [discountCodeFreeShippingCreate](/docs/api/admin-graphql/latest/mutations/discountCodeFreeShippingCreate)<br/>[discountCodeFreeShippingUpdate](/docs/api/admin-graphql/latest/mutations/discountCodeFreeShippingUpdate)<br/>[discountCodeDelete](/docs/api/admin-graphql/latest/mutations/discountCodeDelete) |
| App | [discountCodeAppCreate](/docs/api/admin-graphql/latest/mutations/discountCodeAppCreate)<br/>[discountCodeAppUpdate](/docs/api/admin-graphql/latest/mutations/discountCodeAppUpdate)<br/>[discountCodeDelete](/docs/api/admin-graphql/latest/mutations/discountCodeDelete) |
| Bulk actions | [discountCodeBulkActivate](/docs/api/admin-graphql/latest/mutations/discountcodebulkactivate)<br/>[discountCodeBulkDeactivate](/docs/api/admin-graphql/latest/mutations/discountcodebulkdeactivate)<br/>[discountCodeBulkDelete](/docs/api/admin-graphql/latest/mutations/discountcodebulkdelete) |

### Queries

The following table outlines some common queries for interacting with [automatic and code](#discount-methods) discounts.

| Discount type | Queries |
|---|---|
| Automatic discounts | [automaticDiscountNode](/docs/api/admin-graphql/latest/queries/automaticDiscountNode)<br/>[automaticDiscountNodes](/docs/api/admin-graphql/latest/queries/automaticDiscountNodes) |
| Code discounts | [codeDiscountNode](/docs/api/admin-graphql/latest/queries/codeDiscountNode)<br/>[codeDiscountNodes](/docs/api/admin-graphql/latest/queries/codeDiscountNodes) |


## Getting started

<div class="resource-card-grid">
  <div>
  <a class="resource-card" href="/docs/apps/build/discounts/build-discount-function" data-theme-mode="">
    <div class="resource-card__indicator-container"><img
     src="/assets/resource-cards/tutorial"
     data-alt-src="/assets/resource-cards/tutorial-dark"
     aria-hidden="true"
     class="resource-card__icon themed-image"></div>
    <h3 class="resource-card__title">
      Build a Discount Function
    </h3>
    <p class="resource-card__description">Learn how to create a Discount Function that applies discounts to cart lines, order subtotal, and shipping rates.</p>
  </a>
</div></p>

<p><div>
  <a class="resource-card" href="/docs/apps/build/discounts/build-ui-extension" data-theme-mode="">
    <div class="resource-card__indicator-container"><img
     src="/assets/resource-cards/tutorial"
     data-alt-src="/assets/resource-cards/tutorial-dark"
     aria-hidden="true"
     class="resource-card__icon themed-image"></div>
    <h3 class="resource-card__title">
      Build a UI extension
    </h3>
    <p class="resource-card__description">Add configuration to your discounts experience using metafields and build a user interface with UI extensions.</p>
  </a>
</div></p>

<p><div>
  <a class="resource-card" href="/docs/apps/build/discounts/build-ui-with-remix" data-theme-mode="">
    <div class="resource-card__indicator-container"><img
     src="/assets/resource-cards/tutorial"
     data-alt-src="/assets/resource-cards/tutorial-dark"
     aria-hidden="true"
     class="resource-card__icon themed-image"></div>
    <h3 class="resource-card__title">
      Build a Remix app UI
    </h3>
    <p class="resource-card__description">Add configuration to your discounts experience using metafields and build a user interface with Remix.</p>
  </a>
</div></p>

<p><div>
  <a class="resource-card" href="/docs/apps/build/discounts/network-access" data-theme-mode="">
    <div class="resource-card__indicator-container"><img
     src="/assets/resource-cards/tutorial"
     data-alt-src="/assets/resource-cards/tutorial-dark"
     aria-hidden="true"
     class="resource-card__icon themed-image"></div>
    <h3 class="resource-card__title">
      Add network access
    </h3>
    <p class="resource-card__description">Learn how to add network access to your Discount Function to query external systems for discount validation.</p>
  </a>
</div>
</div>


## Developer tools and resources

Explore the following developer tools and resources to learn more about building with Shopify Functions:

<div class="resource-card-grid">
  <div>
  <a class="resource-card" href="/docs/apps/build/functions" data-theme-mode="">
    <div class="resource-card__indicator-container"><img
     src="/assets/resource-cards/cli"
     data-alt-src="/assets/resource-cards/cli-dark"
     aria-hidden="true"
     class="resource-card__icon themed-image"></div>
    <h3 class="resource-card__title">
      Shopify Functions
    </h3>
    <p class="resource-card__description">Customize the backend logic that powers parts of Shopify.</p>
  </a>
</div></p>

<p><div>
  <a class="resource-card" href="/docs/apps/build/functions/input-output/metafields-for-input-queries" data-theme-mode="">
    <div class="resource-card__indicator-container"><img
     src="/assets/resource-cards/graphql"
     data-alt-src="/assets/resource-cards/graphql-dark"
     aria-hidden="true"
     class="resource-card__icon themed-image"></div>
    <h3 class="resource-card__title">
      Input queries and metafields
    </h3>
    <p class="resource-card__description">Make your code reusable by replacing hard-coded variables in your Function with metafield values.</p>
  </a>
</div></p>

<p><div>
  <a class="resource-card" href="/docs/api/admin-extensions/components" data-theme-mode="">
    <div class="resource-card__indicator-container"><img
     src="/assets/resource-cards/blocks"
     data-alt-src="/assets/resource-cards/blocks-dark"
     aria-hidden="true"
     class="resource-card__icon themed-image"></div>
    <h3 class="resource-card__title">
      Admin UI extension components
    </h3>
    <p class="resource-card__description">Build your user interface using Admin UI extension components.</p>
  </a>
</div></p>

<p><div>
  <a class="resource-card" href="/docs/api/app-bridge" data-theme-mode="">
    <div class="resource-card__indicator-container"><img
     src="/assets/resource-cards/blocks"
     data-alt-src="/assets/resource-cards/blocks-dark"
     aria-hidden="true"
     class="resource-card__icon themed-image"></div>
    <h3 class="resource-card__title">
      Shopify App Bridge
    </h3>
    <p class="resource-card__description">Build your user interface using components from Shopify App Bridge library.</p>
  </a>
</div>
</div>