Create your AGS store

Last updated on October 7, 2026

Overview

This article walks you through how to create your AccelByte Gaming Services (AGS) store in your publisher or game namespace, in the AGS Admin Portal or with the AGS CLI.

Your AGS store can exist in both publisher namespaces and game namespaces. We recommend that game-specific items be configured in a game namespace since a publisher namespace is usually used as a publisher storefront for your game, and downloadable content (DLC) distribution. A publisher namespace is more useful if you are setting up an AGS Player Portal and launching your games using our Launcher, since you can manage sales of your games in them.

note

You also have the option to integrate a third-party store platform with your AGS store. To learn more, see Manage third-party store integrations.

Prerequisites

• You have access to the AGS Admin Portal.
• You have a game or a publisher namespace.
• To follow the AGS CLI steps, you have installed the AGS CLI and signed in with an account that has access to these features. See Install and sign in. The examples use a Bash shell.

Create a store

Admin Portal

1. On the Admin Portal sidebar, go to Online > Store & Catalog > Stores. The Stores page appears.

2. In the Draft Store section, click on the Create Draft Store button. The Create Store form appears. Fill in the required information.

3. Fill in the required information.

   • Title: type in your store name. The store name will be visible in the Launcher and Player Portal.
   • Default Language: select the default language for your store.
   • Default Region: select the default region for your store.
   • Other Languages: select other languages that your store will support besides the default language.
   • Other Regions: select other regions that your store will support besides the default region.
   • Description: type in a brief description for your store.

4. Click Create. The draft store appears on the Stores page.

AGS CLI

1. Create a JSON file with the store's settings. Any file name works. This example uses store.json:

   {
     "title": "<StoreTitle>",
     "description": "<StoreDescription>",
     "defaultLanguage": "en",
     "defaultRegion": "US",
     "supportedLanguages": ["ja"],
     "supportedRegions": ["JP"]
   }

   • title: the store name. The store name will be visible in the Launcher and Player Portal.
   • description (optional): a brief description for your store.
   • defaultLanguage and supportedLanguages: the Default Language and Other Languages, as language tags such as en or ja. Use [] for no other languages.
   • defaultRegion and supportedRegions: the Default Region and Other Regions, as two-letter country codes such as US or JP. Use [] for no other regions.

2. Create the draft store. After @, pass the path to your JSON file:

   ags platform stores create --namespace <YourNamespace> --json @store.json

   The command prints the new store. Its storeId field is the store ID that you use in other commands.

3. To see the stores in your namespace, run:

   ags platform stores list --namespace <YourNamespace> --format json

tip

To try the whole store setup in one command, run the in-game-store workflow. It creates a sample draft store with a virtual currency, categories, and two items, then publishes it. Because it publishes the store, use it in a test namespace that doesn't have a draft store yet.

ags workflow run in-game-store --namespace <YourNamespace>

What's next?

Create item categories to organize your items into groups. Follow the steps in the Create item categories article.