Back to Intelligence
Platform UpdatesGlobal

Shopify POS 11.15 changes how percentage discounts return through extensions

For POS UI extensions, Discount.amount now returns the percentage value—not the money deducted—when Discount.type is Percentage. Older API-version settings do not preserve the previous behavior.

Ecomwith EditorialEcommerce intelligence desk

Published
Updated
Risk
low

Reported details

What happened

Shopify’s changelog says POS 11.15 returns amount: 25 for a 25% discount on a $200 line item; POS 11.14 and earlier returned amount: 50, the monetary deduction.

The change covers cart-level and line-item percentage discounts, including manual, app-applied, and automatic discounts exposed as type: 'Percentage'.

The changelog says the change applies to all POS UI extension API versions. FixedAmount discounts and Code discounts, including percentage-based discount codes exposed as type: 'Code', are unchanged.

The changelog identifies currency displays, savings calculations, loyalty points, and bulkCartUpdate workflows as areas to check.

Business relevance

Why it matters

An extension that treats every Discount.amount as money could display the wrong savings or use the wrong value in downstream calculations when it encounters a Percentage discount.

Because the behavior applies across API versions, retaining an older api_version is not a compatibility strategy; the POS device version and the discount type both matter.

Editorial perspective

Analysis & judgment

  1. The value’s meaning now depends on Discount.type: for Percentage discounts, amount represents a percentage rather than the monetary allocation. That distinction can flow into displays and calculations wherever extensions consume discount data; merchants should check the type before interpreting the value. The supplied changelog does not document how any particular extension handles it.

  2. The change can affect a connected merchant workflow even if the storefront discount itself is correct: an extension that reads the returned value as money may misstate savings or award loyalty points on the wrong basis. Merchants should prioritize reviewing extensions that use discount amounts in those functions; the evidence does not establish that every extension is affected.

  3. A safe compatibility decision depends on both discount type and POS version: test Percentage discounts on POS 11.15 or later, and retain handling for the earlier behavior if supported devices still run POS 11.14 or earlier. The changelog gives no device-upgrade timeline, so deployment coverage must be verified rather than assumed.

Applicability

Seller impact

Merchants using POS UI extensions for currency displays, savings, or loyalty calculations may need an extension update if those workflows interpret Percentage amounts as monetary values.

Extensions that pass cart state back through bulkCartUpdate should be checked for percentage discounts; the changelog says the fix prevents monetary allocation from being reinterpreted as a percentage.

Merchants supporting POS 11.14 or earlier may need to account for the previous behavior until those devices are upgraded.

Action plan

What to do now

  1. 1

    Audit discount amount handling

    now

    If your POS UI extensions consume Discount.amount, check Discount.type before treating the value as currency, especially in displays, savings calculations, and loyalty logic.

  2. 2

    Test affected discount paths

    this-week

    If your extensions handle these discounts, test cart-level, line-item, and automatic Percentage discounts on POS 11.15 or later, including any bulkCartUpdate workflow.

  3. 3

    Check supported device versions

    monitor

    If you still support POS 11.14 or earlier, verify which devices remain on those versions and preserve handling for the previous behavior until they are upgraded.

What not to do yet

  • Do not assume an older API version preserves the previous POS behavior, or interpret every amount as money without checking the discount type.

Sources & context

Evidence and sources

A source may provide only a headline or summary. Read the evidence scope below. Links and workflow checks are not independent fact verification. Internal confidence values are workflow signals, not probabilities of factual correctness.

  1. 01

    Shopify POS 11.15 corrects the value returned by Discount.amount for Percentage discounts to match the Cart API contract. Extensions that used this value as money need to update their logic. What changed A 25% discount on a $200 line item now returns amount: 25. POS 11.14 and earlier returned amount: 50, the monetary amount deducted. This applies to cart-level and line-item percentage discounts, including manual, app-applied, and automatic discounts exposed with type: 'Percentage'. It affects the Cart API's current state and subscriptions, lineItems[].discounts, cartDiscount, cartDiscounts, and the cartLineItem contextual API. This fix also prevents a percentage discount's monetary allocation from being reinterpreted as a percentage when an extension passes cart state back through bulkCartUpdate. FixedAmount and Code discounts are unchanged, including percentage-based discount codes exposed with type: 'Code'. Who's affected The change applies to all POS UI extensions API versions. Keeping an older api_version does not preserve the previous behavior. What to do Check Discount.type before interpreting amount, and update currency displays, savings calculations, loyalty points, and int

    Shopify Developer Changelog · Workflow status: single-source

    Source link

    Retrieved: October 8, 2026 at 12:07 a.m. UTC

    Claim is bounded to the ingested title or summary; no source body or quotation is retained.

Related tutorials and tools

Ecomwith tutorials
Shopify POS 11.15 changes how percentage discounts return through extensions - Ecomwith Intelligence