Briefing

Shopify POS UI Extensions API v2026-07 Adds Component-Level Discount Allocations

e-commerce
Shopify

Use components[].discountAllocations to read bundle component discounts in POS UI Extensions API 2026‑07.

What to do now

Add logic to read components[].discountAllocations and handle missing values when using API v2026‑07.

Summary

Shopify has released POS UI Extensions API version 2026‑07, adding component‑level discount allocation data to product bundle components in cart line items. The new property, components[].discountAllocations, can be accessed via shopify.cartLineItem.components?.[0]?.discountAllocations and is also present in the Cart API cart state through shopify.cart.current.value.lineItems. Previously, only the parent line item exposed discountAllocations while bundle components only showed tax information, making it hard to calculate component‑level discounts for bundled products. This update is additive; apps using API 2026‑04 or earlier do not need to change, but those adopting 2026‑07 must handle the new property and its possible absence or emptiness. The LineItem shape remains unchanged, so existing code that reads line items can now also read component discount allocations without modification. Developers should update their POS UI Extensions to read components[].discountAllocations for accurate reporting, tax, and compliance calculations. The change does not affect other API endpoints or introduce breaking changes. Documentation for the new API can be found on Shopify’s dev site under the Cart Line Item API reference.

Key changes

  • POS UI Extensions API v2026‑07 adds components[].discountAllocations to bundle components
  • Accessible via shopify.cartLineItem.components?.[0]?.discountAllocations
  • Same LineItem shape appears in Cart API cart state via shopify.cart.current.value.lineItems
  • Apps using API 2026‑04 or earlier need no changes
  • Apps adopting 2026‑07 must handle new property and its possible absence or emptiness
  • Change is additive, no breaking changes to existing APIs
  • Previously only parent line item exposed discountAllocations; bundle components had only tax info

Affects

e-com-customers

Customer impact

Analyzing matches…

Ask about this story

Impact on an agency? Which customers? Compare historically Risks of waiting