Reference

In-app purchase information

General Information

The main in-app purchase properties identify the product in App Store Connect and in the app.

Property

Description

Apple ID

A unique identifier automatically generated for your in-app purchase when you add the in-app purchase to your account.

Note: This identifier isn't the same as your Apple ID that you use to sign in to App Store Connect and your developer account.

Reference Name

A unique name you give to your in-app purchase for internal tracking that's not visible to customers, but used in App Store Connect and Sales and Trends reports. The reference name can include any characters and can be as long as 64 characters.

The reference name can be edited at any time without review.

Product ID

A unique ID specific to your app that you can assign to your in-app purchases to uniquely identify them within your app.

The product ID can contain letters, numbers, hyphens, periods, and underscores, and can be as long as 100 characters. You need separate identifiers for in-app purchases in your iOS apps and your macOS apps.

When your app uses StoreKit to communicate with the App Store, it uses product IDs to retrieve the configuration data you provided for each in-app purchase. When a user wants to make a purchase, your app identifies the in-app purchase using its product ID.

The product ID isn't editable after you save the in-app purchase.

Once a product ID is assigned to an in-app puchase, it can't be reused for another in-app purchase within the same app, even if you delete the original in-app purchase with that ID.

Review Notes

Additional information about the in-app purchase that might help Apple review the submission, such as test user accounts and passwords. Review notes should not exceed 4000 characters.

Promotional Image

A promotional image is required if you want to promote your in-app purchase on your App Store product page. This image will represent your in-app purchase in all countries or regions where your app is available for devices running iOS 11 or later. If you’re also using offer codes for auto-renewable subscriptions, your promotional image will appear on the App Store page when customers redeem their codes on iOS 14 or later. You can submit up to 20 in-app purchases, with their respective promotional images, for review at a time. Your promotional image must meet the following requirements:

  • JPG or PNG.

  • Dimensions of 1024 x 1024 pixels.

  • 72 dpi, RGB, flattened and no rounded corners.

Show to all App Store users, even those who don’t have the app installed

An indication that you would like all customers to see your promoted in-app purchases, which is based on the user device information. By default, this is selected. If you deselect the checkbox, but haven’t implemented the SKProductStorePromotionController API, your in-app purchase will not be visible on the App Store. Visit Promote in-app purchases to relevant customers only. Note that a customer needs to have opened your app on their device at least once to see your order and visibility settings inside your app.

App Review Screenshot

A screenshot of the in-app purchase that clearly shows the item or service being offered. This screenshot is used for review only and isn't displayed on the App Store.

Upload a screenshot that meets any of the screenshot specifications your app supports. Once you’ve uploaded a screenshot, you can update it but not remove it.

Localizable information

Add localizable in-app purchases information used in the product display. You must include these properties for at least one language. For a list of languages, visit App Store localizations.

Changes to the localized information require review. The existing text displays on the store until the new text is approved. The change has its own status separate from the overall status of the in-app purchase. Before your changes are reviewed, you can revert the change.

Property

Description

Display Name

The name of the in-app purchase that is displayed to customers. The display name must be at least two characters and no more than 30 characters.

Description

A description of the in-app purchase that potentially displays to users. If you make your in-app purchase available for promotion, this displays under your in-app purchase name on the App Store. The description must be no more than 45 characters.