Catalog schema
Find the fields you can use to define listings in your catalog, including localized content, pricing, and webshop display metadata.
Read time 2 minutesLast updated 22 days ago
The catalog schema defines the structure of a catalog listing in your IAP catalog. Each listing describes its core identity, localized display content, pricing, and optional store metadata. Not all fields apply to every listing. If you sell through a webshop, you can extend a listing with additional display options. Refer to the webshop extension fields.
Listing schema
Refer to the following fields that are available to you when you create a catalog listing:Example catalog
The following catalog listing carries both base catalog fields and webshop extension fields. Prices are expressed in micros, where 1,000,000 is one unit of the currency.[ { "catalogListingId": "gems_medium_default", "uSKU": "com.example.gems.medium", "type": "Consumable", "imageUrl": "https://cdn.example.com/gems-medium.png", "productDetails": [ { "language": "en", "title": "Medium Gem Pack", "description": "A handy stash of gems to spend in game.", "subtitle": "500 gems", "badge": { "text": "Best value", "imageUrl": "https://cdn.example.com/gem-icon.png" } } ], "pricing": [ { "currencyCode": "USD", "amount": 9990000, "webshopPrice": 7990000 } ], "categories": ["gems"], "hdImages": [ { "url": "https://cdn.example.com/gems-medium-hd.png", "altText": "A pile of gems" } ], "promotion": { "type": "Sale", "endsAt": "2026-07-01T00:00:00Z" }, "sortIndex": 10 }]
Additional resources
- Refer to Create an IAP catalog to understand the best method for you to create a catalog.
- Manage your catalog in the Dashboard.