Promotion usage limits

How it works

You can set a limit on how many times a promotion can be used by a user and configure scheduled resets for these limits. Limit configuration is available for discount and bonus promotions. You can enable periodic limit resets to:

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

Once a user reaches the promotion usage limit, the item becomes available at full price without a discount or bonus.

To correctly display the remaining promotion uses available to a user, you must configure authentication.

Unauthenticated users always see the maximum number of promotion uses. To show the user’s remaining promotion uses 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 item purchase limits, refer to the instructions.

Configure and update limits

Configure and update in Publisher Account

To create a number-limited promotion:

1. Open your project in Publisher Account and go to the LiveOps > Promotions section.
2. Click Create promotion.
3. Enter the promotion title.
4. In the drop-down list, choose the Discount or Bonus type.
5. Fill in the fields depending on the type of promotion you have chosen.
6. Click Next.
7. To limit a number of sales, on the Conditions page, set the Limit number of times one user can use promotion toggle to On and enter the number of uses.

8. To set up personalized promotions, set Promotion for only specific users toggle to On and follow these instructions.
9. Click Next.
10. Set the campaign start and end dates. Specify the time zone, start date, and end date. To make the promotion available indefinitely, select No end date.
11. Click Next.
12. Check the settings and click Save and exit.
13. To activate a promotion:
    1. Find the promotion in your promotions catalog.
    2. Click the ••• menu button and select Edit promotion.
    3. In the upper right corner, open the drop-down menu and choose Activate promotion.

To configure or update limits for an existing promotion:

1. Open your project in Publisher Account and go to the LiveOps > Promotions section.
2. In the row with promotion, click ••• and choose Edit promotion in the drop-down list.
3. If the promotion that you need is active, deactivate it in the upper right corner of the drop-down list.
4. On the Condition and limits page, click Refresh this limit manually.
5. Confirm the action and click Save changes.
6. To activate the promotion, in the upper right corner, open the drop-down menu and choose Activate promotion.

Set up and update via API calls

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

• Create discount promotion for item
• Create bonus promotion

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

Display limits in the catalog of items

Promotion usage limits 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. After setting up a promotion usage limit, the item card shows:

• the discount amount for discount promotions
• a bonus message for bonus promotions
• a counter indicating the number of promotional items available for purchase

Get limit information via API

If the catalog is implemented using API, information about promotion usage limits is returned in the promotions.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

You can use this data to display promotion usage limits in the catalog — for example, to show the maximum number of promotion uses available to the user.Last updated: February 13, 2026