IAP Catalog window reference
Reference the In-App Purchasing Catalog to configure and manage product properties and store overrides.
Read time 4 minutesLast updated 8 hours ago
The IAP Catalog is a Unity Editor tool where you define, organize, and manage in-app purchase products in one place. Configure product IDs, product types (consumable, non-consumable, subscription), and store-specific overrides to keep definitions consistent across platforms and stores.
Important
Starting in version 5.4.4, the IAP Catalog window is available only to projects that already have a local catalog. Catalog authoring has moved to the Remote Catalog. To convert a catalog that you defined in this window, refer to Migrate your catalog to the Remote Catalog.
To access the IAP Catalog, open the Unity Editor, and go to Services > In-App Purchasing > IAP Catalog. In version 5.4.4 and later, this menu item is available only if your project already has a local catalog. Refer to Codeless IAP menu item availability.
IAP Catalog properties
The following tables describe the properties you can configure in the IAP Catalog.
Product
Configure the basic properties for each product.
Settings | Description |
|---|---|
| ID | The unique identifier for the product. This must match the identifier used on the target store. |
| Type | The type of product. Select Consumable, Non-Consumable, or Subscription. |
Advanced product settings
Descriptions
Provide product titles and descriptions to support multiple languages in your catalog.
Settings | Description |
|---|---|
| Locale | Determines the app stores available in your region. |
| Title | The localized display name for the product. |
| Description | The descriptive text for your product as it appears in an app store, usually an explanation of what the product is. |
Note
Use Translations to add multiple localized titles and descriptions for a product.
Payouts
Define what the player receives when they purchase the product.
Settings | Description |
|---|---|
| Type | The type of payout (such as Currency, Item, Resource or Other). |
| Subtype | A more specific category within the selected type. |
| Quantity | The amount of the payout delivered to the player. |
| Data | Optional. Use this field as a custom property to reference in code. For example, a flag for a UI element. |
Note
You can add multiple payouts to a single product.
For more information on the class, refer to the Scripting Reference. You can always add payout information to a product in a script using this class.
PayoutDefinitionAn example of payout information using the class:
PayoutDefinitionpublic static ProductDefinition Consumable = new ProductDefinition("coins", "com.outlinegames.100goldcoins", ProductType.Consumable, true, new List<PayoutDefinition> { new PayoutDefinition(PayoutType.Currency, "gold", 100), });
Store ID Overrides
Specify store-specific product identifiers and configuration settings for each supported platform. This ensures your products are correctly mapped and configured for each app store.
Settings | Description |
|---|---|
| AppleAppStore | The product ID as registered on the Apple App Store. |
| GooglePlay | The product ID as registered on the Google Play Store. |
| MacAppStore | The product ID as registered on the Mac App store. |
Note
By default, Unity IAP expects your product to use the same product ID across all app stores. Use consistent IDs across stores whenever possible. Some stores require different IDs. For example, Apple doesn't allow you to use the same product ID in both the iOS App Store and the Mac App Store.
Google Configuration
Define how a product’s price is managed on the Google Play Store.
Settings | Description |
|---|---|
| Price | Enter the price for the product. |
| Pricing Template | Enter an ID for a pricing template created in the Google Play Store. |
Apple Configuration
Define how a product’s price is managed on the Apple App Store.
Settings | Description |
|---|---|
| Price Tier | Select the Apple pricing tier for the product. |
| Pricing Template | Use Select a screenshot to upload the pricing template. |
Note
The prices set in the Google and Apple configurations are used when generating a product list from the Catalog to import into the stores. However, the store is always the source of truth for prices, as it ultimately determines and charges the final amount to the user.
Advanced settings
Configure initialization and additional export and Apple-specific options.
Settings | Description |
|---|---|
| Automatically initialize UnityIAPServices (recommended) | Enable to initialize Unity IAP Services when the application starts. Recommended for most projects. |
| Automatically initialize Unity Gaming Services | Enable to initialize Unity Gaming Services when the application starts. |
| Catalog export | Provides options to export the catalog for app store submission or external use. |
| Apple SKU | The Apple Stock Keeping Unit (SKU) for the product, as defined in App Store Connect. |
| Apple Team ID | The Apple Team ID associated with your Apple developer account. |