> For the complete documentation index, see [llms.txt](https://onestore-dev.gitbook.io/dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://onestore-dev.gitbook.io/dev/eng/webshop/register-item.md).

# Catalog

Configure the products to sell in your Web Shop. Register in-game currencies and items as assets, then use them to create items for sale and display them in the Web Shop.

* **What is an Asset?** Register the base in-game currencies or items used to create products.
* **What is an Item?** Create products for sale in the Web Shop and manage their pricing and display information.

***

## Assets <a href="#id-1" id="id-1"></a>

Create and manage in-game assets. Link them to in-app products to sell them through the Web Shop.

<div data-with-frame="true"><figure><img src="https://2218522982-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgStyyzRzNh9x2u93ZH03%2Fuploads%2FjhkRYyfz6eeQOCFuQrZv%2Fimage.png?alt=media&amp;token=5721e826-0e8b-4c8e-b197-66d32973c922" alt=""><figcaption></figcaption></figure></div>

### Create an Asset

**Asset Name** (Required)\
Enter a name to identify the asset.

**Image**\
Upload an image or icon that represents the asset. JPG or PNG, up to 1 MB.

**Description**\
Enter a description of the asset.

| Item       | Purpose                                          | Resolution   | Format   | File Size  |
| ---------- | ------------------------------------------------ | ------------ | -------- | ---------- |
| Asset Icon | Identifies the asset in lists and search results | 512 × 512 px | JPG, PNG | Up to 1 MB |

<details>

<summary>ℹ️ Image Creation Guidelines</summary>

When creating images, refer to the [Image Creation Guidelines](/dev/eng/tools/icon-guide.md).

</details>

***

## Items <a href="#id-1" id="id-1"></a>

Register items to sell in the Web Shop and manage their pricing and display information.

### Item List

View items by status using the **All / In Progress / On Sale / Sales Suspended / Unavailable for Sale** tabs. You can also search by item name or item ID. The list displays the item name, item ID, price, last updated date, and status.

<div data-with-frame="true"><figure><img src="https://2218522982-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgStyyzRzNh9x2u93ZH03%2Fuploads%2FjEoRWJV39d4MmapaFjRE%2Fimage.png?alt=media&amp;token=b2e3c1b2-26c3-4d7a-acaa-981d5e4c1156" alt=""><figcaption></figcaption></figure></div>

### Create an Item

**Item ID** (Required)\
Must start with a number or lowercase letter and can contain numbers (0–9), lowercase letters (a–z), underscores (\_), and periods (.). Up to 255 characters. **The Item ID cannot be changed after saving.**\
Examples: `gem_100`, `sword_legendary`, `monthly_pass`

<div data-with-frame="true"><figure><img src="https://2218522982-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgStyyzRzNh9x2u93ZH03%2Fuploads%2FufXEXdM2hfTR8LDVPhbp%2Fimage.png?alt=media&amp;token=2662f2bd-bb55-4ace-810d-bdfade6abce3" alt=""><figcaption></figcaption></figure></div>

#### Basic Product Information

**Product Image**\
The image displayed on the product card in the Web Shop. JPG, PNG, GIF, or WebP, up to 2 MB.

**Name** (Required, up to 50 characters) / **Description** (Required, up to 300 characters)\
Enter the product name and description displayed to users.

**Product Details**

**Item Type** (Required)\
Select the item type.

**Price Settings** (Required)\
Enter the base price. For countries configured under **Currency Management**, you can set local prices for each country. For countries without a custom local price, the price automatically calculated from the base price using the exchange rate will be applied.

**Discount Rate (%)**\
Enter 0 for no discount. When a discount rate is set, both the original price and discounted price are displayed in the Web Shop.

**Randomized Items** (Required)\
Select whether the product includes randomized items.

#### Included Assets (Optional)

Add other assets to this product, such as items included in a bundle.

#### Multiple Quantity Purchase

Enable this option to allow players to purchase up to 10 units at once. When disabled, players can purchase only one unit at a time.

{% hint style="info" %}
However, the actual maximum quantity may be lower than 10 depending on the maximum payment amount allowed in each country. Players can purchase only up to the quantity that keeps the total payment amount within the country's maximum payment limit.

**Example:** Even if the maximum purchase quantity is set to 10, if an item costs KRW 500,000 and the maximum payment amount for the country is KRW 2,000,000, the purchase pop-up will allow the player to select up to **4 units** (KRW 500,000 × 4 = KRW 2,000,000).
{% endhint %}