Skip to main content

Fallback paywalls

A paywall is an in-app storefront where customers can see and purchase products within your mobile app. Typically, paywalls are fetched from the server when a customer accesses them.

However, Adapty allows you to have fallback paywalls for situations when a user opens the app without a connection to the Adapty backend (e.g., no internet connection or in the rare case of backend unavailability) and there's no cache on the device.

Adapty generates fallbacks as a JSON file in the necessary format, showing English versions of the paywalls you've configured in the Adapty Dashboard.

To display your fallback paywall to users:

  1. Download the file from the Adapty Dashboard - one file per app store and Adapty SDK version - as described below.
  2. Process the file in your mobile app code:
    1. For iOS: Add the file to your Xcode project bundle and pass the file name to the .setFallback method. See detailed instructions for iOS.
    2. For Android: Place the file in the assets or res/raw directory and pass the file location to the .setFallback method. See detailed instructions for Android.
    3. For React Native: Add the file to your Xcode project bundle for iOS and place it in the android/app/src/main/assets/ or android/app/src/main/res/raw/ directory for Android, then pass the file location to the .setFallback method. See detailed instructions for React Native.
    4. For Flutter: Place the file in your app's assets and pass the asset path to the .setFallback method. See detailed instructions for Flutter.
    5. For Unity: Place the file in your app's StreamingAssets folder and pass the file name to the .SetFallbackPaywalls method. See detailed instructions for Unity.

Download fallback paywalls as a file in the Adapty Dashboard​

To integrate fallback paywalls into your mobile app code, first download them from the Adapty Dashboard.

The downloaded JSON file will contain one paywall for each placement. This will be the paywall assigned to the All users audience in the Adapty Dashboard.

important

Downloading fallbacks is available only for Adapty SDK version 2.11 or later. Upgrade to the later version or use existing fallbacks.

Before you can download a paywall fallback (Click to Expand)
  1. Create products you want to sell
  2. Create a paywall and add the products to it.
  3. Create placement and add paywalls to it. Placement is the location where the paywall will be shown.

To download the JSON file with the fallback paywalls:

  1. Open the Paywalls tab of the Placements section from the Adapty main menu.

  1. In the Products or Placements window, click the Fallbacks button.
  2. Select the platform for the fallbacks - iOS or Android.
  3. In the Download iOS/Android Fallback window, select the SDK version you use for your app and click the Download button.

As a result, you will get a JSON file.