---
title: >-
  The PriceRule resource now supports an allocation limit - 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/the-pricerule-resource-now-supports-an-allocation-limit
  md: >-
    https://shopify.dev/changelog/the-pricerule-resource-now-supports-an-allocation-limit.md
metadata:
  effectiveApiVersion: ''
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: true
  createdAt: '2018-11-28T13:07:09-05:00'
  postedAt: '2018-09-10T00:00:00-04:00'
  updatedAt: '2024-02-02T10:57:29-05:00'
  effectiveAt: '2018-09-10T00:00:00-04:00'
---

September 10, 2018

Tags:

* Action Required
* API

# The PriceRule resource now supports an allocation limit

We're adding a highly requested new parameter to the PriceRule API: `allocation_limit`. This new parameter represents the number of times a discount can be applied to the cart, if eligible. This additional parameter will only be available for Buy X Get Y discount types.

***

For example: If a “Buy 1 Get 1 For Free” discount has an allocation limit of 2, then the discount will only be applied to the cart twice, even if there are more than 4 items.

If no allocation\_limit is specified, the discount will default to unlimited uses in a single cart. If your app doesn't use this new parameter, then all discounts will have unlimited uses.

Apps that have created a Buy X Get Y discount type have been notified via email to their Partner account. If your app is creating these discounts and you have not received the email, then reach out to [deprecations@shopify.com](mailto:deprecations@shopify.com%5D).

Starting today, you can request this parameter be enabled for your application by emailing [deprecations@shopify.com](mailto:deprecations@shopify.com%5D). On September 10, 2018, the parameter will be active for all applications.