App Store Connect Help

Support / App Store Connect / Configure in-app purchase settings / Promote in-app purchases

Configure in-app purchase settings

Promote in-app purchases

iOS

Promoted In-App Purchases appear on your product page, can display in search results, and may be featured on the Today, Games, and Apps tabs.

You can promote up to 20 at a time to display on your App Store product page in all countries or regions on devices running iOS 11 or later. This gives you the flexibility to change the In-App Purchases that appear on your product page at any time based on your business needs — for example, if you’re planning to launch a limited-time price promotion or offer exclusive content. Promoting In-App Purchases can also encourage downloads of your app. When a user doesn’t have your app installed but wants to buy a promoted In-App Purchases, they’ll receive a prompt to download the app first. Once the app is downloaded, the transaction will continue in the app.

Your app must support the PurchaseIntent API in order for the App Store to display your promoted product pages. All in-app purchases and metadata must be approved by App Review.

Learn how to manage promoted in-app purchases and subscriptions with the App Store Connect API.

Required role: Account Holder, Admin, App Manager, Developer, or Marketing. View role permissions.

Add an Image

You must add an image in order to promote an in-app purchase.

  1. From Apps, select your app.

  2. In the sidebar under Monetization, click In-App Purchases. (For non-renewing subscriptions, click Subscriptions, then scroll down to Non-Renewing Subscriptions and click Manage).

  3. Click the in-app purchase you want to promote.

  4. Scroll down to the App Store Image section.

  5. To add an image, click Choose File and upload the image.

Promote an in-app purchase

  1. From Apps, select your app.

  2. In the sidebar under Monetization, click In-App Purchases. (For non-renewing subscriptions, click Subscriptions, then scroll down to Non-Renewing Subscriptions and click Manage).

  3. Click the in-app purchase you want to promote.

  4. Scroll down to the App Store Image section.

  5. Click Promote on the App Store.

  6. In the pop-up window, choose which App Store users will see your promotion. Changes to these settings only impact the in-app purchase you are editing:

    • Show this promotion to all App Store users, even those who don’t have the app installed. If you select this option, but haven't implemented the PurchaseIntent API, your in-app purchase will not be visible on the App Store.

    • Only show this promotion to users who meet your conditions in the app. You can customize the promoted in-app purchase a customer views on a specific device by using the Product.PromotionInfo API. For example, you can hide an item that a customer has already purchased on that device, or show the most relevant levels in a game based on their gameplay. By default, your promoted in-app purchases show on all devices, even those without the app installed.

  7. Find the in-app purchase you wish you promote, and click the checkbox under Promoted. You may also click the reordering control on the left of the in-app purchase name and drag it to a new position to change its order on your App Store Product page.

  8. Click Save.

Keep in mind that if an app is not ready for sale or the in-app purchase is pending approval, it may not be available on your App Store product page even when it is available for App Store Promotion. Allow up to 24 hours for changes to reflect on your App Store product page.

Related StoreKit