Upsell

How it works

Upsell is a sales method in which the user is offered to buy an item with additional value. For example, this could be the item that is in the greatest demand among other users.

An upsell 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 set up one of the upsell options:

  • best-selling items for a certain period (top sellers)
  • items with active discounts or bonuses
  • custom set of items

Limitations:

  • You can only create one upsell per project.
  • Upsell offers can include only items that are displayed in the catalog.
  • If items with regional restrictions are selected for upsell, users from those regions will not be able to buy those items.
  • One upsell can contain up to 100 items.

Upsell setup

Set up via Publisher Account

To create an upsell:

  1. In your project in Publisher Account, go to LiveOps > Upsell.

  1. Click Create upsell.

  1. Select items for upsell. If you selected the option Custom set of items, add the necessary items from the drop-down list.

  1. Click Create upsell.

The created upsell is activated by default and is displayed in the Upsell section. You can edit the existing one or delete it and create a new upsell.

Set up via API

Implement a call to the following methods:

Upsell display in catalog

Display via site builder

To display upsell items on your website:

  1. Create an upsell.
  2. Open your project in Publisher Account and go to the Storefronts > Websites section.
  3. In the pane of the desired site, click Open Site Builder.
  4. In the Store block, go to the Store section.
  5. In the Item type field, select Upsell item.
Note
The block can display only one category of items — either game keys or in-game items (virtual items, virtual currency packs, and bundles). If the upsell contains items from multiple categories, specify the category to display in the block using the Item type for upsell field.

  1. After making all necessary changes and preparing your website for launch:
    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.

Notice

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

After publication, a new section with upsell items will appear on the site. After successfully purchasing an item on the site, the user will see a modal window with an offer to buy more items from the list of upsell items.

Get upsell data via API calls

If a list of items for upsell is configured in the project in the Publisher Account, you can get them via the Get list of upsell items in project call.

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: February 13, 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 doc_feedback@xsolla.com.