# Add a catalog listing

> Create a new listing in your catalog directly from the Unity Dashboard.

The **Add catalog listing** dialog is where you create and configure a single catalog listing in the Unity Dashboard.

## Add a catalog listing

Open **In-App purchases** in the Unity Dashboard to add a catalog listing:

1. Select **Catalog** > **Add catalog listing**.
2. Configure your catalog listing. Refer to the [Add catalog listing reference](#add-catalog-listing-reference).
3. Select **Add**.

## Add catalog listing reference

Refer to the following tables to understand your configuration options.

### Add catalog listing fields

The **Add catalog listing** dialog contains the following fields.

| **Field**                | **Required**                  | **Description**                                                                                                                                                                                                            |
| :----------------------- | :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Catalog listing ID**   | Yes                           | Sets a unique identifier for this listing, distinct from the **uSKU**. The Dashboard uses this value as the config file name. The same in-game item can have several listings, each with a unique listing ID.              |
| **uSKU**                 | Yes                           | Sets the product's unique identifier (SKU), which identifies the in-game reward to grant after a purchase. The same uSKU can appear across multiple listings. Changing this value can affect existing receipt resolutions. |
| **Type**                 | Yes                           | Sets the product type. Select **Consumable** for items a player can buy repeatedly, **Non consumable** for one-time purchases, or **Subscription** for recurring purchases.                                                |
| **Image URL**            | No                            | Sets the URL of the image shown on the listing card.                                                                                                                                                                       |
| **Webshop availability** | Required for webshop listings | Makes the listing available in your webshop catalog when you select **Sell this SKU on Webshop too**.                                                                                                                      |

If you enable **Webshop availability**, the following webshop sections also apply to the listing:

* [Webshop promotions](#webshop-promotions)
* [Webshop badge](#webshop-badge)
* [Webshop fields](#webshop-fields)
* [Webshop pricing](#webshop-pricing)

For more information about webshop listings, refer to [Catalog and payments in webshops](../webshop/catalog-and-payments).

#### Webshop promotions

The following fields apply only when you enable **Webshop availability**.

| **Field**             | **Required** | **Description**                                                                                                                                                                                                                                                                                                                                                                        |
| :-------------------- | :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Webshop promotion** | No           | Applies a promotion treatment to the listing card in the webshop. Select **None**, **Sale**, **Bonus**, or **Limited**. **Sale** autofills **Badge text** with the percentage difference between the base price and the webshop price. **Limited** autofills **Badge text** with the time remaining before the end date. You can overwrite the autofilled text in **Product details**. |
| **Schedule**          | No           | If you select a webshop promotion, this sets the **Start date** and **End date** that control when the promotion treatment displays. Use the `MM/DD/YYYY hh:mm` format. Applies only when you set a **Webshop promotion**.                                                                                                                                                             |

### Localization

The **Localization** section contains the following fields.

| **Field**            | **Required** | **Description**                                                                                                                                    |
| :------------------- | :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Primary language** | Yes          | Sets the default language for the listing's display details. Select **+ Language** to add another language to the listing.                         |
| **Localization**     | No           | Lists the locales added for the listing. Displays **No locale added** until you add a language. Add a locale to provide localized display details. |

### Product details

The **Product details** section contains the following fields. Select **Localize** beside a field to provide a value for each added language.

| **Field**       | **Required** | **Description**                                       |
| :-------------- | :----------- | :---------------------------------------------------- |
| **Title**       | Yes          | Sets the listing's display name, shown to players.    |
| **Subtitle**    | No           | Sets an optional secondary line shown with the title. |
| **Description** | No           | Sets the player-facing description of the listing.    |

#### Webshop badge

The following fields apply only if you select **Sell this SKU on Webshop too**:

| **Field**           | **Required** | **Description**                                                                                                                                                  |
| :------------------ | :----------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Badge text**      | No           | Sets the text of the chip shown on the listing card, up to 32 characters. Autofilled for webshop sales and limited-time listings, but you can overwrite it here. |
| **Badge image URL** | No           | Sets the URL of optional `imageUrl` for an icon shown beside the badge text.                                                                                     |

### Pricing

The **Pricing** section contains the following fields.

| **Field**           | **Required** | **Description**                                                                                                                                                                |
| :------------------ | :----------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Base price**      | Yes          | Sets the price charged for the listing. At least one price in `USD` is required. Select **Add** (**+**) to add a currency, or the calculator to convert from another currency. |
| **Localized price** | No           | Lists the per-currency prices added for the listing. Displays **No currency added** until you add a currency.                                                                  |

### Store ID overrides

The **Store ID overrides** section contains the following fields. Use these fields to map the listing to a store-specific product ID. You can only use these fields for platform native stores.

| **Field**           | **Required** | **Description**                                                     |
| :------------------ | :----------- | :------------------------------------------------------------------ |
| **Apple App Store** | No           | Sets the product ID to use for this listing in the Apple App Store. |
| **Google Play**     | No           | Sets the product ID to use for this listing in Google Play.         |

### Webshop fields

The **Webshop** section contains the following fields. These fields apply only when you enable **Webshop availability**.

| **Field**             | **Required**                  | **Description**                                                                                                                                  |
| :-------------------- | :---------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------- |
| **Webshop category**  | Required for webshop listings | Assigns the listing to a webshop category. Select a category that you've defined for your webshop. A listing can belong to up to 16 categories.  |
| **SKU display order** | No                            | Sets the listing's display order across the shop. Lower values appear first.                                                                     |
| **hdImage URL**       | No                            | Sets a high-resolution image shown in the listing detail dialog, with optional **Alt text**. Select **Add** (**+**) to add more images, up to 8. |

### Webshop pricing

The **Webshop pricing** section contains the following fields. These fields apply only when you enable **Webshop availability**.

When you set a webshop price that's lower than the base price, an `N% OFF` badge is applied automatically. You can override it with **Badge text** in **Product details**.

| **Field**                   | **Required**                  | **Description**                                                                                                                        |
| :-------------------------- | :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------- |
| **Webshop base price**      | Required for webshop listings | Sets the price shown on the webshop, which can differ from the **Base price**. Select the calculator to convert from another currency. |
| **Webshop localized price** | No                            | Lists the per-currency webshop prices added for the listing. Displays **No currency added** until you add a currency.                  |
