Paywalls
Customize the paywalls of your app using different products, messages, and designs, all without new app releases
Paywalls are collections of digital products that enable you to modify the 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.
Paywalls list
To access the functionality for managing paywalls in the Adapy dashboard, you should navigate to the Paywall tab within the Products and Paywalls section.

The paywall list page in the Adapy dashboard provides an overview of all the paywalls that have been set up in your account.
You can also use filters on this page to refine your search and locate specific paywalls. For example, you can filter paywalls by placement to see only those that are associated with a particular placement, or by state to view paywalls based on their current status.
Paywall states
Paywalls can exist in one of four states:
- 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.
- 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.
- Archived - These paywalls are not in use and have been archived. You can unarchive an archived paywall and make it active again if needed.
Paywall structure
A paywall consists of the following main elements:

- Paywall name: The name that identifies the paywall throughout the Adapty Dashboard.
- Products: An ordered set of products that will be shown to your customers. 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.
- Promotional offers (optionally): To use promotional offers, you have to upload Subscription Key to Adapty Dashboard, so Adapty can sign the offers.

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.
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
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
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
Localizations
You can have several localizations of your paywall to fit different countries and cultures. The option of having all localizations in one JSON is still available for the legacy paywalls and versions of the SDK, but we recommend adding localizations separately as we'll drop the support for it in the next few months.

Add localizations to your list
Please note that if you update your Adapty SDK version to 2.3.0 and later, 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 necessaryremoteConfig
values.
Table view for localizations
Table view is especially useful when dealing with multiple localizations at once. You can easily push values from your default locale to all the other ones and check for unexpected missing values (treated as null
in JSON form):

Use the three-dotted button to sync values from default locale
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
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
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
Updated 6 days ago