Free items

Free items are the type of items that the user can get without spending virtual or real currency. These include:

  • Virtual items
  • Bundles
  • Game keys
  • Virtual currency packages

Free items are only available to authorized users.
Unauthorized users can only view the catalog of free items.

Examples of usage:

  • You can give away free items on important dates for your project (for example, on the day the project was founded) to reward users for their loyalty.
  • You can give away free starter packs for the game in the store to attract new users to the game.

You can limit the number of free unique items.

Who can use it

  • For partners who have already have Web Shop and want to set up a new type of product — free items.
  • For partners who want to increase the loyalty of current users or attract new players.

Integration flow

Create free items in the following ways:

Create via Publisher Account

To create a free item (based on the example of virtual items):
  1. Open your project in Publisher Account.
  2. Click Store in the side menu.
  3. In the Virtual Items pane, click Configure.
  4. Click the + icon and choose Create group from the drop-down list.
  5. Specify:
    • External ID;
    • Group name.
  6. Click Create group and go to the group.
  7. Click Create item.
  8. Specify:
    • Image
    • SKU
    • One or several groups the item should belong to
    • Name
    • Description
    • Item property: consumable, nonconsumable, or time-limited item
Currently, you can give away only consumable items.
  1. In the Price settings block, choose Free item.
  2. If you want to limit the availability of items to specific users, switch the Limit number of times one user can buy this item toggle to On and specify the number.
  3. If you want to show an item in the store, set the Show item in store toggle to On.
  4. Click Create item.

Create via API calls

  1. To create free items, use API calls from the Admin subsection:When creating or editing an item, pass is_free = true in the request body.
  2. Get a user’s order status.
  3. If you want to limit the availability of items to specific users, call any API method for creating or editing an item and specify the value of the limits.per_user parameter.

Set up in Web Shop

To show free items in Web Shop:
  1. Open your project at Publisher Account and go to Site Builder.
  2. In the Site section, choose your site and click Configure.
  3. In the Store block, go to the Store section.
  4. In the Select purchase type field, select free items that you added previously.
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.
Rate this page
Rate this page
Is there anything we can improve?

Don’t want to answer

Thank you for your feedback!
Last updated: January 22, 2024

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!