New purchaseType and recurringCycleLimit fields in the discounts API for discount UI extensions
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on June 17, 2026.
This Shopify update is categorized as API, New, Admin Extensions, 2026-04.
What changed
You can now configure purchaseType and recurringCycleLimit for app discounts directly from discount UI extensions using the discounts plugin. Previously, these fields were only accessible through the GraphQL Admin API. App developers building discount UI extensions had no way to let merchants control whether a discount applies to one-time purchases, subscriptions, or both, or how many subscription billing cycles a discount should apply to. The following fields are now available through the discounts plugin: purchaseType: control whether the discount applies to one-time purchases, subscriptions, or both recurringCycleLimit: set the number of billing cycles a subscription discount applies to (such as, a value of 4 applies the discount on the first 4 orders, then stops). A value of 0 means unlimited.
Who is affected
Developers building or maintaining Shopify checkout customizations should review this change.
What action may be needed
Review whether the new capability is relevant to your app. If you plan to use it, test the affected API or workflow before adopting it in production.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →