> For the complete documentation index, see [llms.txt](https://purchasely.gitbook.io/purchasely/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://purchasely.gitbook.io/purchasely/3.4/advanced-features/promoting-your-products/promoting-in-app-purchases.md).

# Promoting In-App Purchases

{% hint style="info" %}
Only available on iOS SDK
{% endhint %}

### What are promoted In-App Purchases

You can use the [Promoting In App Purchase feature](https://developer.apple.com/app-store/promoting-in-app-purchases/) to increase the visibility of your purchases in the App Store. These items are searchable on the App Store and can be purchased directly from the store.

It is a great way to improve your ASO and conversion.

![Example of promoted In App Subscriptions](/files/-MLMvytLfm10dtXe-Fbm)

### Choosing the visual

In App Store Connect, you will select the App Store product (a plan) to promote and add a promotional artwork following [Apple Guidelines](https://developer.apple.com/app-store/promoting-in-app-purchases/).

In Purchasley console, select the presentation associated to that plan and that will be displayed before the purchase.

### Implementation

Here is **what we do for you**:

* Once a product is purchased we make sure that it won't be visible on the App Store page of your app to make more room to other products you might be selling<br>
* Apple says: "*If you are offering an auto-renewable subscription, you’ll need to explain how auto-renewal works in the purchase flow within your app*".\
  In that case we pop the product offer paywall once your app is started.

To ensure that we won't be popping the paywall during on boarding or loading … you need to call the following method when your app is ready:

{% tabs %}
{% tab title="Swift" %}

```swift
Purchasely.isReadyToPurchase(true)
```

{% endtab %}
{% endtabs %}

### Testing

To test the flow before you submit your app or your promotion, you can do the following:

```
itms-services://?action=purchaseIntent&bundleId=APP_BUNDLE_ID&productIdentifier=IN_APP_PRODUCT_ID
```

Replace `APP_BUNDLE_ID` and `IN_APP_PRODUCT_ID` by the appropriate values and paste it into Notes app. Clicking on it will start a purchase action just like the App Store would.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://purchasely.gitbook.io/purchasely/3.4/advanced-features/promoting-your-products/promoting-in-app-purchases.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.