---
title: >-
  Discounts Allocator Function API developer preview has ended - 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/discounts-allocator-function-api-developer-preview-has-ended
  md: >-
    https://shopify.dev/changelog/discounts-allocator-function-api-developer-preview-has-ended.md
metadata:
  effectiveApiVersion: ''
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
    - displayName: Functions
      handle: functions-api
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: true
  createdAt: '2026-08-28T09:53:07-04:00'
  postedAt: '2026-09-10T12:00:00-04:00'
  updatedAt: '2026-09-10T10:11:29-04:00'
  effectiveAt: '2026-09-29T12:00:00-04:00'
---

September 10, 2026

# Discounts Allocator Function API developer preview has ended

DateSeptember 10, 2026

FlagsUpdate[Action required](https://shopify.dev/changelog?action_required=true)

SurfacesAPI

Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)[Functions](https://shopify.dev/changelog?api_type=functions-api)

The Discounts Allocator Function API, available only through the Discounts Allocator developer preview, has been removed and won’t be released. The developer preview is closed. Most developers don’t need to take action. The one exception is an app that still declares the `purchase.discounts-allocator.run` extension target.

## What changed

The Discounts Allocator Function API let an app control how discounts were allocated across cart lines.

Since the preview opened, native control over how discounts apply has improved, including stacking multiple product discounts on the same line. We believe the majority of use cases are now served by these mechanisms, so it no longer makes sense to carry the Discounts Allocator API forward as a long-term Function API. Discount allocation stays with Shopify’s platform logic.

This change includes:

* The `discountsAllocatorFunctionRegister` and `discountsAllocatorFunctionUnregister` mutations are removed from the unstable version of the Admin GraphQL API. They were never available in a stable version.
* Functions registered during the preview are unregistered for you.
* The API reference and the “Build a discounts allocator” tutorial are removed from <https://shopify.dev>.

To continue creating discounts with a function, use the Discount Function API described in the Discounts developer documentation at <https://shopify.dev/docs/apps/build/discounts>.

## Who’s affected

* Apps that participated in the Discounts Allocator developer preview and registered a Discounts Allocator Function.
* Apps whose configuration still declares the `purchase.discounts-allocator.run` extension target.

Apps that never used the Discounts Allocator Function API or its extension target aren’t affected and don’t need to change anything.

## Action required

If your app declares the `purchase.discounts-allocator.run` extension target, remove that extension from your app configuration.

Until you remove it, `shopify app deploy` fails for the entire app, including changes to your other extensions, with `API not found for target: purchase.discounts-allocator.run`. Existing app releases remain installable, but their Discounts Allocator Functions no longer run. Other app functionality is unaffected. The failure happens the next time you deploy.

After you remove the extension and redeploy, `shopify app deploy` succeeds and your other extensions continue to update as expected.

## Related docs

* Learn how to build discounts with the Discount Function API in the Discounts developer documentation: <https://shopify.dev/docs/apps/build/discounts>