Create an IAP catalog

Understand catalogs and the best way to create your catalog listings.

Read time 2 minutes

Last updated 5 days ago

An IAP catalog is a list of all the digital items available for purchase in your application, including their IDs, types, prices, and store-specific overrides. Unity In-App Purchasing (IAP) uses this catalog to communicate with app stores and present catalog listings to your players.

Catalog authoring has moved to the Remote Catalog. You can also define your listings with a script. Regardless of the method you use, you can use the Unity Dashboard to manage, edit, and deploy your catalog.

A catalog that you defined in the IAP Catalog window continues to work, and you can keep using that window. Starting in version 5.4.4, that window is available only to projects that already have a local catalog. The recommended best practice is to migrate to the Remote Catalog, which gives you the following benefits:

Change your products and your prices without your players having to update your application.
Configure your product information once, instead of once for each payment provider.
Deploy your catalog from the Unity Editor or the Unity Cloud CLI.

Note

To use a Direct-to-Consumer (D2C) payment provider, you need to create a Remote Catalog.

Catalogs and catalog listings

Understand how to use catalogs in Unity IAP, and choose the best method to define your catalog listings.

Create Remote Catalog

Define your IAP catalog and upload it to the Remote Catalog service.

Catalog schema

Find the fields you can use to define listings in your catalog, including localized content, pricing, and webshop display metadata.

Create your catalog programmatically

Define your catalog listings with scripts.

Set up store credentials for catalog import

Add your App Store Connect or Google Play key as a credential so that Unity can read your listings when you import a catalog.