Item purchase limits

How it works

You can set a purchase limit per user and configure scheduled resets for these limits.

Limit configuration is available for the following scenarios:

• sale of in-game items — virtual items, virtual currency packages, and bundles
• sale of games and DLC via game keys

You can enable periodic limit resets to:

• allow repeat purchases
• synchronize data with your system when items are sold across multiple game publishing platforms

To correctly display the quantity available to a user, you must configure authentication. Unauthenticated users always see the maximum quantity of items they can purchase. To display the user’s remaining quantity of items with the active limit applied, include user authorization data when requesting:

• the item catalog using calls from the Catalog subsection of Virtual Items & Currency group
• the game catalog using calls from the Catalog subsection of Game Keys group

To configure promotion usage limits, refer to the instructions.

Configure and update limits

Configure and update in Publisher Account

To create an item with a limited number of uses:

1. Open your project in Publisher Account and go to the Items catalog > All items > Virtual items section.
2. Click Add and select Virtual items.

3. Specify the following parameters:
   • image
   • SKU
   • one or several groups the item should belong to
   • name
   • description
   • prices

4. To limit the number of times a user can buy an item, set the Limit the number of times one user can buy this item toggle to On and specify the limit.
5. To set how often limits are refreshed:
   1. In the drop-down list, select the period:
      • Daily
      • Weekly
      • Monthly
      • Custom interval. The interval is calculated starting from the start date of the item’s display period in the store.
      • No regular refresh

1. 2. Set the update schedule by specifying the parameters corresponding to the period.

6. To set a display period for the item in the catalog, select Limited time, specify the time zone, start date, and end date. To make the item available indefinitely, select No end date.
7. Click Create item.

To configure or update limits for an existing item:

1. Open your project in Publisher Account and go to the Items catalog > All items > Virtual items section.
2. Open the group containing the item.
3. In the row of the item, click ••• and choose Edit in the drop-down list.
4. In the Limits for single user section, set the limit and/or select the limit reset frequency, then specify the time and time zone.
5. Click Save changes.

Set up and update via API calls

To set daily, weekly, or monthly limits, pass the recurrent_schedule array in the following API calls:

• Create virtual item
• Create game
• Create virtual currency
• Create virtual currency package
• Create bundle

To update and manage limits, use the API calls from the Limits section:

Display limits in the catalog of items

Limits on item sales are displayed in the catalog depending on how it is implemented — either through the site builder or via API.

Display via site builder

If you use the site builder, limits are displayed automatically — an item card shows a counter of items available to the user.

Get limit information via API

If the catalog is implemented using API, limit information is returned in the items.limits array in the following catalog-related API calls:

• Get virtual items list
• Get virtual currency list
• Get virtual currency packages list
• Get bundles list
• Get games list

Items for which the user has reached their purchase limit are returned with can_be_bought = false. You can update these limits as needed. This data can be used to display limits in the catalog — for example, to show the maximum number of items available for purchase.

Useful links

Last updated: February 13, 2026