Create store items

Last updated on December 23, 2024

Overview

This article walks you through how to create items that you want to sell in your store.

New items can only be created in a draft store. The items in a published store cannot be modified.

Prerequisites

• You have access to the AGS Admin Portal.
• You have a game or a publisher namespace.
• You have an existing draft store with item categories.

Item types

You can create the following items:

Item	Description	Applicable namespace
In-Game Item:	A durable or consumable item used by players in-game. Before you can create in-game items, you will need to register an App with the Game type in your store.	Publisher, Game
Bundle	A package containing one or more items from your store combined into a single purchasable item. You must create at least two items before you can make a bundle.	Publisher, Game
Coin	Credit that can be used to top up a player's virtual currency wallet.	Publisher, Game
Code	Used by players to redeem apps, in-game items, bundles, etc.	Publisher, Game
Media	Items such as music, exclusive art, etc.	Publisher, Game
Option Box	Contains a list of other items. Players can choose one item to keep when opening an option box.	Publisher, Game
Loot Box	Contains a list of other items that have individual probabilities for appearing when a loot box is opened.	Publisher, Game
Extension	Used with custom services to allow players to purchase fulfill custom items. Extensions can currently only be created via the API.	Publisher, Game
App	Used for application items such as games, demos, DLC, etc.	Game
Subscription	Used to create a subscription package.	Publisher
Season	A limited-time-only event that uses passes and tiers to engage participating players.	Publisher

Create store items

App

1. On the Admin Portal sidebar, go to Commerce > Stores. The Stores page appears.

2. Click on the View button of the draft store. The Draft Stores page appears.

3. Click on the + Create Item button. The "Create Item" fom appears.

4. Fill in the required information as follows:

   Basic Information

   • Item Type: select App.
   • Item Name: type in the name for the item.
   • Category: select the applicable category for the item.
   • App Type: select the type of the App: Demo, DLC, Game, or Software.
   • App ID: this is a unique identifier made up of alphanumeric characters, and is used to identify your game when you upload it. Note that you can't change the App ID after it has been defined.

   Store Configuration

   • SKU Number: assign an SKU number to the item.

   • Item Purchase Limit: define the purchase limit of this item for your store. For example, if you set the item purchase limit to 100, this means that 100 units of that particular item will be available for purchase in your store. To make this value unlimited, use -1.

   • Entitlement Type: this is set to Durable by default.

   • Store Display Order: set the order in which the item will be displayed in the Player Portal among the item list.

   • Display Order: set the order in which the item will be displayed in the Player Portal among the item list.

   • Visible in Store and Purchasable in Store

     • Visible in Store: select True to make the item visible, or False to hide the item from your published store.
     • Purchasable in Store: select True to make your item available for purchase, or False to make it unavailable for purchase.

     These two options are configured together and can be set up in the following scenarios:

     • Select True for Visible in Store and True for Purchasable in Store settings for items that you want to be immediately available for purchase in the store.
     • Select True for Visible in Store and False for Purchasable in Store if you want to give a preview of the item to players but the item will be available at a later time.
     • Select False for Visible in Store and True for Purchasable in Store to save items as drafts which can be worked on later.

   • Features: this field works like a tag. Use this field to include a feature of the item, for example, Christmas Special Edition, Summer Beach, Blinky Mushroom Era, etc. Each item can have more than one feature. So items can be freely grouped based on their assigned features. This field is optional.

   • Extension: use this field to add further information to an item for custom usage. This must be written in a valid JSON format. For example, some special attributes like color, attack power can be defined using extension. An array of objects is not allowed.

5. Click Create. The App item is created in the draft store under your selected category.

Coin

1. In the AGS Admin Portal, go to E-Commerce > Stores. The Stores page appears.

2. Click on the View button of the draft store. The Draft Stores page appears.

3. Click on the + Create Item button. The "Create Item" fom appears.

4. Fill in the required information as follows:

   Basic Information

   • Item Type: select Coin.
   • Item Name: type in the name for the item.
   • Category: select the applicable category for the item.
   • Currency Code: the currency code for the coin associated with the item.

   Store Configuration

   • SKU Number: assign an SKU number to the item.

   • Item Purchase Limit: define the purchase limit of this item for your store. For example, if you set the item purchase limit to 100, this means that 100 units of that particular item will be available for purchase in your store. To make this value unlimited, use -1. -User Purchase Limit: define the purchase limit of this item for each account. For example, if you set the user purchase limit of this item to 100, this means that 100 units of that particular item will be available for purchase in your store, for each account. To make this value unlimited, use -1.

   • Entitlement Type: this is set to Durable by default.

   • Item Use Count: define the number of times this item can be used.

   • Stack Entitlement: set to True if the item should be stackable. If not, set to False.

   • Store Display Order: set the order in which the item will be displayed in the Player Portal among the item list.

   • Visible in Store and Purchasable in Store

     • Visible in Store: select True to make the item visible, or False to hide the item from your published store.
     • Purchasable in Store: select True to make your item available for purchase, or False to make it unavailable for purchase.

     These two options are configured together and can be set up in the following scenarios:

     • Select True for Visible in Store and True for Purchasable in Store settings for items that you want to be immediately available for purchase in the store.
     • Select True for Visible in Store and False for Purchasable in Store if you want to give a preview of the item to players but the item will be available at a later time.
     • Select False for Visible in Store and True for Purchasable in Store to save items as drafts which can be worked on later.

   • Section Exclusive: if you want the item to only be sold when it's assigned to a section, turn to the toggle to Active.

   • Features: this field works like a tag. Use this field to include a feature of the item, for example, Christmas Special Edition, Summer Beach, Blinky Mushroom Era, etc. Each item can have more than one feature. So items can be freely grouped based on their assigned features. This field is optional.

   • Extension: use this field to add further information to an item for custom usage. This must be written in a valid JSON format. For example, some special attributes like color, attack power can be defined using extension. An array of objects is not allowed.

   Pricing Configuration

   • Currency namespace: the source of your currency.
   • Currency Code: the currency code used to purchase the item.
   • Default price: if you want to make an item free, set the price to 0. When you set a price in real currency, set the last two digits as decimals, i.e., if you have selected $ as your current symbol, 1.99 will set your item as $1.99 in your store.

5. Click Create. The item is created in the draft store under your selected category.

Subscription

1. In the AGS Admin Portal, go to E-Commerce > Stores. The Stores page appears.

2. Click on the View button of the draft store. The Draft Stores page appears.

3. Click on the + Create Item button. The "Create Item" fom appears.

4. Fill in the required information as follows:

   Basic Information

   • Item Type: select Subscription.
   • Item Name: type in the name for the item.
   • Category: select the applicable category for the item.

   Store Configuration

   • SKU Number: assign an SKU number to the item.

   • Entitlement Type: this is set to Durable by default.

   • Visible in Store and Purchasable in Store

     • Visible in Store: select True to make the item visible, or False to hide the item from your published store.
     • Purchasable in Store: select True to make your item available for purchase, or False to make it unavailable for purchase.

     These two options are configured together and can be set up in the following scenarios:

     • Select True for Visible in Store and True for Purchasable in Store settings for items that you want to be immediately available for purchase in the store.
     • Select True for Visible in Store and False for Purchasable in Store if you want to give a preview of the item to players but the item will be available at a later time.
     • Select False for Visible in Store and True for Purchasable in Store to save items as drafts which can be worked on later.

   • Features: this field works like a tag. Use this field to include a feature of the item, for example, Christmas Special Edition, Summer Beach, Blinky Mushroom Era, etc. Each item can have more than one feature. So items can be freely grouped based on their assigned features. This field is optional.

   • Extension: use this field to add further information to an item for custom usage. This must be written in a valid JSON format. For example, some special attributes like color, attack power can be defined using extension. An array of objects is not allowed.

   Pricing Configuration

   • Currency namespace: the source of your currency.
   • Currency Code: the currency code used to purchase the item.
   • Default price: if you want to make an item free, set the price as 0. When you set a price in real currency, set the last two digits as decimals. For example, if you have selected $ as your current symbol, 1.99 will set your item as $1.99 in your store.

   Subscription Configuration

   • Billing Cycle: define how often subscribing players will be billed. You can choose to charge users Weekly, Monthly, Quarterly, or Yearly.
   • Grace Period: Give players extra time to pay in case of payment processing issues. The default setting is 7 days.
   • Trial Plan: choose between Free Trial, Paid Trial, or No Trial.
     • If you choose Free Trial, set the Trial Period Length in days.
     • If you choose Paid Trial, set the Trial Period Length in billing cycle units and set the Trial Price.

5. Click Create. The item is created in the draft store under your selected category.

Option Box

1. In the AGS Admin Portal, go to E-Commerce > Stores. The Stores page appears.

2. Click on the View button of the draft store. The Draft Stores page appears.

3. Click on the + Create Item button. The "Create Item" fom appears.

4. Fill in the required information as follows:

   Basic Information

   • Item Type: select Option box.
   • Item Name: type in the name for the item.
   • Category: select the applicable category for the item.
   • Currency Code: the currency code for the coin associated with the item.

   Store Configuration

   • SKU Number: assign an SKU number to the item.

   • Item Purchase Limit: define the purchase limit of this item for your store. For example, if you set the item purchase limit to 100, this means that 100 units of that particular item will be available for purchase in your store. To make this value unlimited, use -1. -User Purchase Limit: define the purchase limit of this item for each account. For example, if you set the user purchase limit of this item to 100, this means that 100 units of that particular item will be available for purchase in your store, for each account. To make this value unlimited, use -1.

   • Entitlement Type: this is set to Durable by default.

   • Item Use Count: define the number of times this item can be used.

   • Stack Entitlement: set to True if the item should be stackable. If not, set to False.

   • Store Display Order: set the order in which the item will be displayed in the Player Portal among the item list.

   • Visible in Store and Purchasable in Store

     • Visible in Store: select True to make the item visible, or False to hide the item from your published store.
     • Purchasable in Store: select True to make your item available for purchase, or False to make it unavailable for purchase.

     These two options are configured together and can be set up in the following scenarios:

     • Select True for Visible in Store and True for Purchasable in Store settings for items that you want to be immediately available for purchase in the store.
     • Select True for Visible in Store and False for Purchasable in Store if you want to give a preview of the item to players but the item will be available at a later time.
     • Select False for Visible in Store and True for Purchasable in Store to save items as drafts which can be worked on later.

   • Section Exclusive: if you want the item to only be sold when it's assigned to a section, turn to the toggle to Active.

   • Features: this field works like a tag. Use this field to include a feature of the item, for example, Christmas Special Edition, Summer Beach, Blinky Mushroom Era, etc. Each item can have more than one feature. So items can be freely grouped based on their assigned features. This field is optional.

   • Extension: use this field to add further information to an item for custom usage. This must be written in a valid JSON format. For example, some special attributes like color, attack power can be defined using extension. An array of objects is not allowed.

   Pricing Configuration

   • Currency namespace: the source of your currency.
   • Currency Code: the currency code used to purchase the item.
   • Default price: if you want to make an item free, set the price to 0. When you set a price in real currency, set the last two digits as decimals, i.e., if you have selected $ as your current symbol, 1.99 will set your item as $1.99 in your store.

5. Click Next to go to the Add Items section.

6. Click on the +Add Items button and follow these steps to start adding items to the option box. Note that you can only add existing in-game, coins, and app items to an option box.

   1. Type: select the corresponding type of the item you want to add.
   2. Item Name: type in the name of the item to search for it.
   3. Quantity: set the item quantity tat will be added to the option box.
   4. Ownership Period: you can set the ownership to one of the following:
      • Permanent: set permanent ownership to the player.
      • Duration: set how many days a player can own the item.
      • Expiration date: set an expiration date for the player's ownership of the item.

7. To add more items to the option box, click + Add More Items.

8. After adding items, click Save. You will see a list of items you've added to the option box.

9. Click Create to finish creating the option box item.

What's next?

After creating items for your store, you can proceed to publishing your store. Follow the steps in the Publish a store article.