Import a catalog
Import an existing catalog into the Unity Dashboard to create or replace your catalog.
Read time 3 minutesLast updated 7 days ago
Use catalog import to pull your existing listings from App Store Connect or Google Play directly into the Unity Dashboard. When you import, Unity retrieves your listings using the credential you provide and adds new listings to your catalog. For listings that already exist, you can choose to skip or overwrite them.
Prerequisites
Before you import a catalog, meet the following requirements:
- Your role allows you to change the catalog. Organization owners and managers have this access, but a plain user has read-only access to the catalog. Without access to change the catalog, the Import catalog button stays disabled.
- You have a store credential stored in Secret Manager: an App Store Connect API key for iOS, or a Google Play service account key for Android. For more information, refer to Set up store credentials for catalog import.
Import from App Store Connect or Google Play
The Import catalog dialog has two steps. The first step connects to the store, and the second step previews what Unity found. Unity writes nothing to your catalog until you confirm on the second step.
To import a catalog from the Unity Dashboard, follow these steps:
- Open In-App Purchases > Catalog, then select Import catalog.
- Select the platform you want to import from, either iOS or Android.
- Select the credential for your platform. To build a credential from the key that the store issued to you, select Add credential.
- In the app identifier field, enter the bundle ID of your app on iOS, or its package name on Android. This field appears after you select a credential.
- Select Continue. Unity connects to the store and lists the listings it found.
- Review the listings and their statuses. For more information, refer to Import statuses.
- Resolve every listing that has a Conflict status. Choose Skip duplicates to keep the existing listing, or Overwrite existing to replace it with the imported version.
- Select Import.
Unity imports the listings you accepted and skips any listing that has an Error status. Importing can overwrite existing values in the environment named in the dialog.
If the import fails, the dialog names the cause and, under Show technical details, gives you the underlying error and a request ID. For the cause and resolution of each failure, refer to Troubleshooting catalog import.
Import statuses
Each listing in the review step has a status tag:
Status | Description |
|---|---|
| New | No listing with this uSKU exists in the catalog yet. |
| Conflict | The listing already exists in your catalog. Compare the existing and incoming values, then choose to skip or overwrite it. |
| No changes | The listing matches what's already in your catalog, so importing it changes nothing. |
| Error | The listing has a missing or invalid required field. Unity skips it. Correct the listing in the store and import again. |
Deploy a Remote Catalog from the Editor or CLI
You don't have to import a catalog to manage it on the Dashboard. When you deploy a Remote Catalog from the Unity Editor or the CLI, Unity adds those listings to the Unity Dashboard automatically. You can then manage, edit, and deploy them from the Dashboard alongside any catalogs you import.