Configure in-app purchase settings

Promote in-app purchases

iOS

You can promote in-app purchases and subscriptions on your App Store product page if you’ve added a promotional image and your app is an iOS app. In the App Store Promotions section, you can add and reorder your promoted in-app purchases. You can have an unlimited number of in-app purchases in this list, but can only 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. Learn about promoting in-app purchases.

Your app must support either PurchaseIntent or paymentQueue(_:shouldAddStorePayment:for:) in order for the App Store to display your promoted product pages. All in-app purchases and metadata must be approved by App Review.

Note that in-app purchase promotion isn't currently available on the App Store for iMessage.

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 or remove in-app purchases for promotion

  1. From Apps, select your app.

  2. In the sidebar under Monetization, click App Store Promotions.

  3. Click Edit.

  4. Select the in-app purchases you wish to promote.

  5. Click Save.

Add or remove in-app purchase for promotion.

You can add or remove in-app purchases for promotion at any time. 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.

Customize the order of your promoted in-app purchases

  1. From Apps, select your app.

  2. In the sidebar under Monetization, click App Store Promotions.

  3. Click Edit.

  4. Navigate to the in-app purchase you want to modify, then 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.

  5. Click Save.

Change order of promoted in-app purchases.

Allow up to 24 hours for changes to reflect on your App Store product page.

Promote only relevant in-app purchases to customers

You can customize the promoted in-app purchase a user sees on a specific device by using Product.PromotionInfo or SKProductStorePromotionController APIs.

For example, you can hide an item that a user has already purchased on that device, or show the most relevant levels in a game based on their gameplay. You must configure this setting on your in-app purchase page in App Store Connect in addition to supporting the required StoreKit APIs. By default, your promoted in-app purchases show on all devices, even those without the app installed.

  1. From Apps, select your app.

  2. In the sidebar under Monetization, click In-App Purchases.

  3. Click on the in-app purchase you want to modify.

  4. Scroll down to the App Store Promotion (Optional) section.

  5. Under “Show to all App Store users, even those who don't have the app installed”, click Change Visibility. In the dialog that appears, click Save. Note that a customer needs to have opened your app on their device at least once to view relevant promoted in-app purchases.

    • To show the promotion to everyone regardless of whether they have your app installed or a compatible device, select the checkbox “Show to all App Store users, even those who don't have the app installed”. If you deselect the checkbox but haven't implemented the API, your in-app purchase will not be visible on the App Store.

  6. Click Save.

Promote to relevant customers.
Related StoreKit