Documentation

Support

In-App Purchasing

In-App Purchasing

Products and catalogs

Understand how to define, organize, and manage Unity IAP products using the Unity IAP Catalog.
Read time 2 minutesLast updated 10 hours ago
In Unity IAP, a product is any digital item that users can purchase within your application, such as virtual currency, new game levels, premium features, or subscriptions. You can define your products in two main ways:
  • Access the IAP Catalog window in the Unity Editor (recommended for most projects).
  • Define products directly in your scripts.
Every product is defined by a standard set of attributes that control its behavior and how it appears to users and in the digital store. To implement coded IAP, call 
ProductCatalog.LoadDefaultCatalog
 to access the IAP Catalog in your scripts. For codeless IAP, the catalog is integrated automatically, so no additional action is required. If you prefer to define your own products in code, Unity also provides the optional 
CatalogProvider
 class, which helps simplify the process of creating a custom catalog.

Product attributes

Each product has several key attributes that determine its behavior and presentation:

Product ID

The Product ID is a unique, cross-platform identifier for your product. It is used to communicate with the app stores and can be overriden with store-specific IDs if needed. Product IDs must only contain lowercase letters, numbers, underscores, and periods.

Product types

The Product type defines how an item can be purchased and whether it can be restored. The following product types are available:

Type

Description

Examples

ConsumableA product that a user can purchase multiple times and is depleted upon use. Consumable products can't be restored. For example, virtual currency or temporary power-ups.* Virtual currencies
* Health potions
* Temporary power-ups
Non-ConsumableA product that a user can only purchase once. These items are permanently owned and can be restored after reinstalling the application. For example, unlocking a new character or removing ads.* Weapons or armor
* Access to extra content
* No ads
SubscriptionA product that grants access to content or features for a set period. For example, monthly VIP access or a battle pass.* Monthly access to an online game
* VIP status granting daily bonuses
* A free trial

Payouts

The Payout attribute (optional) specifies the content a user receives after a successful purchase, such as "100 Gold Coins". Specify the payout to associate each transaction with a particular item and quantity, for example, 100 Gold Coins. The Payouts attribute simplifies in-game inventory management and ensures users receive the correct rewards or items for their purchases.

IAP Catalog

The IAP Catalog is a Unity Editor window that provides a codeless, visual interface to define and manage your product list. The catalog is the required method for implementing Codeless IAP and provides a central location in the Unity Editor to configure product attributes, pricing, and store-specific information.

Additional resources