Paywalls

Customize the paywalls of your app using different products, messages, and designs, all without new app releases

Paywalls are collections of digital products displayed to your customers without requiring app updates. This means that you can dynamically adjust the products available for purchase based on various factors, such as customer subscriptions, geographic location, device type, and more. With paywalls, you have the flexibility to offer targeted and customized product sets to your users, which can help improve customer satisfaction and revenue generation.

In the example below, we have two paywalls: Paywall A and Paywall B. Paywall A is shown to the "US users" audience; Payball B is shown to the "Facebook users" and "All users" audiences. Showing the same paywall to multiple audiences within one placement can be useful if you want to compare metrics independently.

Create a paywall

To access the functionality for managing paywalls in the Adapy dashboard:

  1. Open the Products and Paywalls section in Adapty main menu and click the Paywall tab to open it. The paywall list page in the Adapy dashboard provides an overview of all the paywalls that have been set up in your account.
  1. Click the Create paywall button.
  1. In the opened Paywalls/ New paywall page, enter the Paywall name: The name that identifies the paywall throughout the Adapty Dashboard.

  2. Click the Add product button.

  3. From the opened drop-down list, select the Products that will be shown to your customers. The list contains only previously created products. The order of the products is preserved on the SDK side, so it's important to consider the desired order when configuring the paywall. Additionally, you can specify an Apple promotional offer for a product if desired.
    Please consider that after creation, it should not be possible to edit, add, or delete products to the paywall as this may affect the paywall metrics.

    🚧

    Make sure to indicate Bundle ID for iOS and Package Name for Android in Adapty Dashboard, without them SDK can't fetch product info from stores.

  1. You can also add promotional Offers. To use promotional offers, you have to upload Subscription Key to Adapty Dashboard, so Adapty can sign the offers.
  1. Click the Create as a draft button to confirm the paywall creation.

Now the paywall is created and in the Draft state.

Paywall states

Paywalls can exist in one of four states:

  • Draft - These paywalls have not been used in any placements or A/B tests. Draft paywalls are used as a preparation stage for A/B testing, allowing you to show them to others before running the test. A draft paywall can be converted to a running A/B test.
  • Live - These paywalls are currently running for placements and A/B tests. Live paywalls can be used in multiple A/B tests and are associated with several objects. You may run one or more A/B tests based on a live paywall if you are sure that the current run is effective.
  • Inactive - These paywalls have been used previously in placements but are not currently live. You can use an inactive paywall to run a new A/B test or archive it if it is no longer needed.
  • Archived - These paywalls are not in use and have been archived. You can unarchive an archived paywall and make it active again if needed.

Customizing paywalls

Adapty offers several options to customize your paywalls:

Adapty paywall builder

Adapty Paywall Builder is a no-code tool that allows you to create custom paywalls easily. With its simple and flexible interface, you can design and customize paywalls to meet your specific requirements without the need for coding.

Adapty paywall builder

Adapty paywall builder

For detailed information on how to use the Adapty paywall builder, please refer to our documentation.

Paywall remote config

This option allows you to use custom JSON payloads to modify your paywalls. You can specify various parameters, including titles, images, fonts, colors, HTML content, and more.

Adapty paywall remote config

Adapty paywall remote config

You can enter any JSON formatted data up to 10 kB. You can access this data from SDK using remoteConfig or remoteConfigString properties of AdaptyPaywall, and make some adjustments to your paywall. Here are some examples of how you can use a remote config.

{
    "screen_title": "Today only: Subscribe, and get 7 days for free!"
}

# Test titles or others texts
{
    "background_image": "https://adapty.io/media/paywalls/bg1.png"
}

# Test images on your paywall
{
    "font_family": "San Francisco",
    "font_size": 16
}

# Test fonts
{
    "subscribe_button_color": "purple"
}

# Test colors of buttons, texts etc.
{
    "photo_gallery": "https://adapty.io/media/paywalls/link-to-html-snippet.html"
}

# Any HTML code that can be displayed on the paywall
{
    "hard_paywall": true
}

# By setting it to true, you disalow skipping paywall without subscribing
# You have to handle this logic in your app
{
    "title": {
        "en": "Try for free!",
        "es": "¡Prueba gratis!",
        "ru": "Попробуй бесплатно!"
    }
}

You can combine different options, and make up your own. This way you can test different titles, texts, images, fonts, colors, and so on.

Remote config table view

If it's not common for you to work with code and there is a need to correct some values of the JSON, Adapty has a JSON table view for you.
It is a copy of your JSON in a format of a table that is easy to read and understand. The columns are type, key, and value. Color coding helps to recognize different data types. We automatically check the values and types mapping and show you an alert if your corrections may lead to an invalid JSON.

Types of data are automatically checked to avoid mistakes and help to keep JSON valid after corrections

Types of data are automatically checked to avoid mistakes and help to keep JSON valid after corrections

Localizations

You can have several localizations of your paywall to fit different countries and cultures. The legacy option of having all localizations in one JSON is still available, but we recommend adding localizations separately as the old way will be deprecated in several months.

Add localizations to your list

Add localizations to your list

🚧

Please note that if you update your Adapty SDK version to 2.3.0, but do not enable this feature in the dashboard, the SDK will not receive any values for remoteConfig. Therefore, it is recommended that you enable and configure the feature using the With Localization option in your dashboard after updating your SDK version to ensure that you receive the necessary remoteConfig values.

Duplicate the paywall

If you want to reuse an existing paywall in Adapty, you can use the Duplicate functionality to quickly create a copy of it. When you choose to Duplicate a paywall, all of its data is copied, including its name, ordered products, and promotional offers (if any). The word Copy is added to the name of the new paywall to distinguish it from the original. This is a useful feature if you want to create a new paywall that is similar to an existing one but with some minor modifications.

Duplicate paywall

Duplicate paywall

Please note that the Duplicate option is available both from the paywall detail and paywall list pages.

Archiving paywall

In Adapty, you can choose to archive or delete paywalls that are no longer needed.

To archive the paywall, open it, click Archive paywall, and confirm the action by entering the paywall name you're about to archive. All archived paywalls are stored in the paywall list and find them by filtering by archived state, and you can still view the metrics.

Archive paywall

Archive paywall

🚧

The paywalls which are included in any paywall groups or are in usage in any active placement or A/B test can not be archived. You should remove the paywall from placement, stop the A/B test or remove it from the paywall group to proceed.

Additionally, for archived paywalls, there is a Back to active functionality available. Clicking on the Back to active option brings the paywall back from the archived state, making it active again and restoring its previous functionality.

The Archive paywall option is available both from the paywall detail and paywall list pages.

Paywall metrics

Adapty collects metrics such as views, conversions, conversion rate, revenue, ARPPU, and ARPU to help you measure the performance of your paywalls. These metrics provide valuable insights into the effectiveness of your monetization strategy. For detailed definitions and calculations of each metric, please refer to the paywall metrics documentation.

Paywall metrics

Paywall metrics