New purchaseType and recurringCycleLimit fields in the discounts API for discount UI extensions

Shopify Adds Subscription Discount Controls to Discount UI Extensions

Shopify now supports purchaseType and recurringCycleLimit fields in the discounts plugin for discount UI extensions. These fields allow merchants to configure whether discounts apply to one-time purchases, subscriptions, or both, and to set limits on subscription billing cycles directly from the discount UI.

Previously, developers could only set these parameters through the GraphQL Admin API. This meant discount UI extensions lacked native controls for subscription-specific discount configurations, forcing developers to build separate workflows or limit functionality in their extensions.

What This Means for Developers

App developers building discount UI extensions can now provide merchants with complete discount configuration options within a single interface. The purchaseType field controls whether a discount applies to one-time purchases, subscription purchases, or both purchase types. The recurringCycleLimit field sets the maximum number of subscription billing cycles a discount remains active.

This update eliminates the need to route merchants to separate API-based configuration tools for subscription discount settings. Developers building subscription-focused discount apps or general discount management tools can now offer full feature parity between their UI extensions and API-based implementations.

Implementation Considerations

The fields are available through the discounts plugin in discount UI extensions. Developers should update their extensions to expose these controls where relevant to their app’s functionality. Apps that previously required merchants to configure subscription discount parameters through separate interfaces can now consolidate these settings into the discount creation workflow.

Read the full announcement →