Create discount promotion

Discount promotions are a convenient marketing tool for attracting attention to items and increasing sales.

You can apply a discount to any number of items, and any number of discounts can be applied to a single item. The system automatically calculates both the discounted and original prices, ensuring accurate display of information in the store.

Notice

You can set up different types of promotions for an item: discounts, promo codes, and bonuses.

If several promotions are valid for an item at the time of purchase, discounts are applied to the item one by one. The order in which discounts are applied does not matter.

For example:

The price of a virtual item is $10. In your account, the following promotions have been created for the virtual items:

  • Black Friday discount promotion with a discount of 10% from November 4–30
  • Sale discount promotion with a discount of 20% from November 15 – December 15
  • promotion with a promo code for a 5% discount from November 4–30

If the item is purchased on November 20, both discount promotions and a promotion with a promo code are valid.

The total cost of the virtual item is then calculated as (($10 - 10%) - 20%) - 5% and will be $6.84.

Create discount promotions

To create a discount promotion:

  1. In your project in Publisher Account, go to the LiveOps > Canvas section.
  1. In the project in your account for mobile games, go to the Operation > LiveOps section.
  1. In the project in your account, go to the LiveOps > Canvas section.
  1. In the project in your account, go to the LiveOps > More > Canvas section.
  1. Start creating a promotion in one of the following ways:
    • Option 1:
      1. In the toolbar, click the  icon.
      2. In the promotion list area, click the + icon.
      1. Select Discount and click Create.
    • Option 2: In the toolbar, click the + icon and select Discount.
    • Option 3: Open the context menu anywhere on the canvas and select Discount.
  1. Specify the promotion name.
  2. Specify the discount percentage.
  3. Select the items to which the discount will apply:
    1. In the Promotional items field, click Select items.
    2. In the window that opens, check the boxes next to the required items.
    3. Click Add items.
  1. Click Next.
  2. Add conditions and limitations (optional):
    • To give users a discount on an item for their first purchase, set the First-time buyer discounts toggle to active.
    • To set a limit on how many times a user can use the promotion, set the Discount limits toggle to active and enter the required number.
    • To create a personalized promotion (for example, available only to users above a certain in-game level), set the Custom user discounts toggle to active and specify the necessary conditions.
Note

To set up a personalized promotion, user attributes must be configured.

You can define one or multiple conditions for a personalized promotion. Keep in mind that while the promotion is active, you can’t modify it.

  1. Click Next.
  2. Specify the promotion period.
  3. Click Next.
  4. Review the promotion settings.
  5. To activate the promotion immediately (optional), set the Create in Active status toggle to active.
  6. Click Create.
  1. To add the created discount promotion to the site (optional):
    1. Open the site in the builder by clicking Open or Open in Site Builder on the banner in the editing form.
    2. Follow the instructions from the Display discounted items in store section.
Note
Active promotions can’t be edited. To change a promotion’s settings, first deactivate it.

To manage their display, click the or icon to the right of the promotional item card, next to the  icon. If an item is included in multiple promotions, you can display the link for only one promotion at a time.

Note

When setting up a promotion via the canvas, the following options are not available:

  • Setting up a promotion with game keys.
  • Setting a discount with fractional percentages.
  • Setting up a promotion with no end date.

Advanced options for configuring discount promotions are available via Publisher Account and API calls.

Note

When setting up a promotion via the canvas, the following options are not available:

  • Setting up a promotion with game keys.
  • Setting a discount with fractional percentages.
  • Setting up a promotion with no end date.

Advanced options for configuring discount promotions are available via API calls.

Note

When setting up a promotion via the canvas, the following options are not available:

  • Setting up a promotion with game keys.
  • Setting a discount with fractional percentages.
  • Setting up a promotion with no end date.

Advanced options for configuring discount promotions are available in your account and via API calls.

Display discounted items in store

If you sell items through your own interface, you can retrieve item pricing information, including discounted prices, by calling client API methods to get an item catalog (calls from the Common > Catalog, Virtual Items and Currency > Catalog, and Bundles > Catalog subsections).

If your site is created using Xsolla site builder, a timer appears on an item’s card 30 days before the end of the promotion to show the remaining time:

  • If the end of the promotion is in more than a week, the timer shows days and hours.
  • If the end of the promotion is in more than one day, the timer shows hours and minutes.
  • If the end of the promotion is in less than a day, the timer shows minutes and seconds.

To change the color of the timer and discount amount:

  1. In your project in Publisher Account, go to the Storefronts > Websites section.
  2. Select your site and click Open Site Builder.
  1. Open the project in your account and go to the Storefronts > Website section.
  2. Click the pane of your site.
  1. Open the project in your account and go to the Storefronts > Website section.
  2. Click the pane of your site.
  1. Open the project in your account and go to the Storefronts > Website section.
  2. Click the pane of your site.
  1. Open the project in your account and go to the Web Shop section.
  2. Click the pane of your site.
  1. In the side menu, go to the Theme section.
  2. Select a new color in the Secondary field.
  1. To apply changes, publish the website:
    1. In the upper-right corner of the site builder, click Publish.
    2. Check the boxes next to the pages you want to publish.
    3. Click Publish.
Note

If site publication is not available, make sure all the conditions are met:

Was this article helpful?
Thank you!
Is there anything we can improve? Message
We’re sorry to hear that
Please explain why this article wasn’t helpful to you. Message
Thank you for your feedback!
We’ll review your message and use it to help us improve your experience.
Last updated: August 24, 2026

Found a typo or other text error? Select the text and press Ctrl+Enter.

Report a problem
We always review our content. Your feedback helps us improve it.
Provide an email so we can follow up
Thank you for your feedback!
We couldn't send your feedback
Try again later or contact us at [email protected].