---
title: >-
  New purchaseType and recurringCycleLimit fields in the discounts API for
  discount UI extensions - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/new-purchasetype-and-recurringcyclelimit-fields-available-in-the-discount-ui-extension-api
  md: >-
    https://shopify.dev/changelog/new-purchasetype-and-recurringcyclelimit-fields-available-in-the-discount-ui-extension-api.md
metadata:
  effectiveApiVersion: 2026-04
  affectedApi:
    - displayName: Admin Extensions
      handle: admin-extensions
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-04-02T14:31:30-04:00'
  postedAt: '2026-06-17T14:00:00-04:00'
  updatedAt: '2026-06-17T13:13:33-04:00'
  effectiveAt: '2027-04-03T12:00:00-04:00'
---

June 17, 2026

Tags:

* Admin Extensions
* 2026-04

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

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.

These fields work with both `DiscountCodeApp` and `DiscountAutomaticApp` discount types, and the values are enforced by purchase type filtering at checkout.

**No action is required.** To start using these fields, update your discount UI extension to include them in your discounts plugin configuration.

For more details, see the [API documentation for `DiscountAutomaticAppInput`](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DiscountAutomaticAppInput).