How to group and sort items in catalog

You can add items in groups to create a multilevel catalog. The group can include identical and different types of items:

• Virtual items
• Virtual currency
• Packages of virtual currency
• Bundles
• Game keys

Main features:

• Add the same item in several groups.
• Add smaller groups to bigger ones to create a multilevel catalog.
• Change the order of the groups.
• Change the order of items.

Set up groups in one of the following ways:

• via Publisher Account (only for virtual items)
• via API calls

Set up via Publisher Account

Create group

To create a group for virtual items:

1. Open your project in Publisher Account.
2. Click Store in the side menu.
3. In the Virtual items pane, click:
   • Connect – if you don’t have virtual items.
   • Configure – if you previously connected virtual items.
4. Click + and select Create group in the drop-down list.

5. Specify the following parameters:
   • External ID — unique group code.
   • Group name.
6. Set the Show group in Store toggle to On.
7. Click Create group.

Edit group

To edit a group:

1. Open your project in Publisher Account.
2. Click Store in the side menu.
3. In the Virtual items pane, click ••• and in the drop-down list, select Edit group.

4. Make the necessary changes.

5. Click Save changes.

Add item to group

Sort items

1. Open your project in Publisher Account.
2. Click Store in the side menu.
3. In the Virtual items pane, click:
   • Connect – if you don’t have virtual items.
   • Configure – if you previously connected virtual items.
4. Go to the group.
5. Hover over the virtual item number. The ☰ icon will be displayed. Drag the virtual item to the new position.

Set up via API calls

Add item to group

To add an item to the existing group via API calls, pass the array containing the external_id parameter of the groups that the item should belong to in the group field:

• Game keys — Use the Create game, Update game by SKU, and Update game by ID API calls.
• Virtual items — Use the Create virtual item and Update virtual item API calls.
• Virtual currency — Use the Create virtual currency and Update virtual currency API calls.
• Packages of virtual currency — Use the Create virtual currency package and Update virtual currency package API calls.
• Bundles — Use the Create bundle and Update bundle API calls.

Example of the request:

{
   "sku": "sword",
   "name": {
      "en": "Sword",
   },
   "is_enabled": true,
   "is_free": false,
   "order": 1,
   "description": {
      "en": "A sword is a bladed melee weapon intended for cutting or thrusting that is longer than a knife or dagger, consisting of a long blade attached to a hilt.",
   },
   "prices": [
      {
         "amount": 100,
         "currency": "USD",
         "Is_enabled": true,
         "is_default": true
      }
   ],
   "vc_prices": [ ],
   "is_show_in_store": true,
   "groups": [
   "chests", "bonus"
],
}

Get list of groups

Filter items

1. Get the list of items via the following API calls:
   • Game keys — Get games list API call.
   • Virtual currency — Get virtual currency list API call.
   • Packages of virtual currency — Get virtual currency package list API call.
   • Bundles — Get list of bundles API call.
2. Using the filtering, find the items with the external_id parameter of the required group specified in the groups parameter.