Add a catalog listing
Create a new listing in your catalog directly from the Unity Dashboard.
Read time 4 minutesLast updated 22 days ago
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:- Select Catalog > Add catalog listing.
- Configure your catalog listing. Refer to the Add catalog listing reference.
- 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. |
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 |
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 |
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 |
| 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, anN% OFFField | 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. |