Admin GraphQL API / 2026-04

On a single cart line,
you can now stack multiple product discounts

In GraphQL Admin API 2026-04, you can now apply multiple product discounts to a single cart line (line item). This feature supports the ongoing migration from Shopify Scripts, which will be deprecated on June 30, 2026.

On this page
  1. What's actually changing (understand in 30 seconds)
  2. Diagram: multiple discounts on one line item
  3. Why now: relation to the Scripts deprecation (June 30, 2026)
  4. Before vs 2026-04 comparison
  5. 5 points developers should know
  6. 3 use cases you can apply to your business
  7. 1-line summary you can use in proposals

1What's actually changing

In the 2026-04 version of the GraphQL Admin API,you can now apply multiple product discounts to a single cart line (a single line in the cart).
This lets you continue migrating from Shopify Scripts , which will be deprecated on June 30, 2026.
%

Before: one product discount per line item

Only a single product discount could be applied to the same cart line. It was hard to reproduce the "stacked discounts" you'd built with Scripts using the Admin API.

2026-04: multiple product discounts per line item

You can now apply multiple product discounts to the same cart line. For discount combination settings, refer to the GraphQL Admin API documentation.

The scope is product discounts; the article does not mention order discounts or shipping discounts. The upper limit on the number of applicable discounts and the calculation order are also not stated in the article.

2Diagram: multiple discounts on one line item

One cart line (one line item in the cart) Product discount A Product discount B Product discount C Multiple discounts applied to the same line item A applied B applied C applied = stacking can be expressed See the Admin API docs for combination settings
A/B/C in the diagram illustrate the concept that "multiple product discounts ride on the same line item." The specific discount types, combination rules, application order, and maximum count are not stated in the article. Check the GraphQL Admin API documentation for what can actually be configured.

3Why now: the connection to the Scripts sunset

Scripts

Shopify Scripts will be sunset on June 30, 2026

The article explicitly states a "June 30th, 2026 sunset date." Merchants need to migrate their Scripts logic before the sunset date.

Admin API 2026-04

A move to let migration "continue"

The article explains that this feature enables "merchants to continue migrating Scripts." Stacking multiple discounts can now be expressed on the Admin API side, removing one barrier to migration.

The article does not name a specific destination platform for Scripts migration or provide detailed migration steps. The only guidance it gives is to "refer to the GraphQL Admin API documentation for discount combination settings."

4Before vs. 2026-04 comparison

ItemBeforeGraphQL Admin API 2026-04
Product discounts on the same cart line Up to one Multiple can be applied
Migrating stacked discounts from Scripts Hard to reproduce with the Admin API Can continue to be migrated
Target API version — GraphQL Admin API 2026-04
Discount combination settings — Refer to the GraphQL Admin API documentation
Application limits / calculation order / eligible plans — Not stated

55 points engineers should know

2026-04

1. The target is GraphQL Admin API 2026-04

This feature is introduced in the 2026-04 version. To use it, you need to align your API version with 2026-04.

2. Constraint relaxed: multiple discounts on a single line

The previous constraint of "one product discount per cart line" is removed, and multiple product discounts can be applied to the same line.

6/30

3. The main purpose is to keep Scripts migration moving

This feature is designed to keep migration moving forward ahead of the Shopify Scripts sunset on June 30, 2026. Rather than a new feature addition, it is positioned as paving the migration path.

4. See the documentation for combination settings

How to configure discount combinations is left to the GraphQL Admin API documentation rather than the article. Required reading before implementation.

5. Unconfirmed items are not stated in the article = verify them yourself

The maximum number of discounts that can be applied, the calculation/application order of multiple discounts, eligible plans, whether the scope is limited to product discounts (treatment of order discounts and shipping discounts), and backward compatibility with existing discount APIs are allnot statedin the article. Always verify in a sandbox and against the official documentation before applying in production.

63 use cases you can apply at work

Scripts Admin 2026-04
USE CASE 1

Preserving "stacked multiple discounts" in Scripts migration projects

Challenge
You built logic in Shopify Scripts to "stack multiple discounts on the same product," but Scripts will be sunset on June 30, 2026. With the previous Admin API, only one product discount could be applied per line, so it could not be reproduced.
Action
Upgrade the GraphQL Admin API to 2026-04 and migrate to a configuration that applies multiple product discounts to a single cart line.
Result
Complete the migration from Scripts while preserving the behavior of existing stacked discounts before the deprecation deadline.
Technical notes
See the GraphQL Admin API documentation for how to configure discount combinations. The maximum number of applicable discounts is not stated.
Limited-time sale Member discount Coupon
USE CASE 2

Running multiple campaigns at once (sale × member × coupon)

Problem
We wanted to run a limited-time sale, member discount, and coupon at the same time, but only one discount could be applied to the same product, which required operational effort to decide which to prioritize.
Approach
With 2026-04, switch to a design that applies multiple product discounts to the same line item and lets campaigns stack instead of being mutually exclusive.
Outcome
Less need for exclusivity rules that assume campaigns will compete with each other, giving more freedom in planning and messaging.
Technical notes
The calculation order, limits, and exclusion rules when stacking are not stated in the article. Check the combination settings in the Admin API documentation.
Tier discount Volume discount Seasonal discount
USE CASE 3

Carrying tiered B2B / wholesale discounts as separate entries on one line item

Problem
We wanted to stack a customer-tier discount, volume discount, and seasonal discount on the same product, but previously had to roll them up into a single discount and manage the breakdown logic separately.
Approach
Apply each discount as an individual product discount on the same cart line, keeping the logic separate instead of combining it into one.
Outcome
Tier, volume, and seasonal discounts can be treated as separate discounts, making it easier to operate and maintain a segmented discount design.
Technical notes
The article does not specify how the breakdown is preserved or displayed, or the order of application. Verify the behavior in a sandbox and the GraphQL Admin API documentation before implementing.

7One-line summary you can use in a proposal

"With GraphQL Admin API 2026-04,you can stack multiple product discounts on a single cart line.
The goal is to keep the migration from Shopify Scripts (deprecated on June 30, 2026) moving forward without interruption.
Details such as limits and order are not stated — combination settings must be confirmed in the official documentation."