Learn how to use Superwall in novel ways to increase your revenue. Discover common patterns you can use today and come back often as we update this page with new tips.

Recipes

Superwall

Superwall gives you the ability to remotely update your purchase screen (a.k.a. paywall), without shipping app updates. Changing things like pricing, design, location, text and discounts takes a few seconds from Superwall's dashboard.

Welcome

If you need fine-grain control over the purchasing pipeline, use a purchase controller.

Handling Purchases

Manually Handling Purchases and Subscription Status

If you want to use RevenueCat to handle your subscription-related logic with Superwall, follow this guide.

Using RevenueCat

Here's how to view whether or not a user is on a paid plan or not.

Tracking Subscription State

Use a Superwall delegate to help interface with 3rd party analytics, see which product was purchased on a paywall, handle custom placements and more.

Using the Superwall Delegate

It's important to tell Superwall when a deep link has been opened. This enables a few things:

Deep Links

You can set the click behavior of any element on a paywall to be a custom paywall action. This allows you to tie any tap in your paywall to hard-coded application logic.

Custom Paywall Actions

Use Observer mode to report purchases made outside of Superwall so they'll appear in your dashboard. Available for iOS and Android.

Observer Mode

If you wish to purchase products directly on iOS and Android, use our SDK's `purchase` methods.

Purchasing Products Outside of a Paywall

SuperwallKit supports Game Controller input.

Game Controller Support

(iOS only) When submitting your app for review, you'll need to fill out an App Store Privacy label. When using the Superwall SDK, there are a few choices you may need to consider.

App Store Privacy Labels

(iOS only) StoreKit testing in Xcode is a local test environment for testing in-app purchases without requiring a connection to App Store servers. Set up in-app purchases in a local StoreKit configuration file in your Xcode project, or create a synced StoreKit configuration file in Xcode from your in-app purchase settings in App Store Connect. After you enable the configuration file, the test environment uses this local data on your paywalls when your app calls StoreKit APIs.

Setting up StoreKit testing

Ready to ship your app with Superwall? Here is a last minute checklist to give you confidence that you're ready to ship without issue.

Pre-Launch Checklist

Let customers purchase products online via Stripe, and them link them to your iOS app with one seamless flow. No authentication required.

Overview

Add a Stripe app to an existing project within Superwall.

Creating an App

Create your Stripe keys to connect Superwall to Stripe. Fill out some settings to configure your app.

Configuring Stripe Keys and Settings

Create products in Stripe to show on your web paywalls.

Creating Stripe Products

Learn how to use campaigns and placements to present web paywalls using Superwall's web checkout links.

Web Checkout Links

Learn how to handle users redirecting back to your app after a web purchase.

Post-Checkout Redirecting

Handle a deep link in your app and use the delegate methods.

Redeeming In-App

Handle a deep link in your app and use the delegate methods to link web checkouts with RevenueCat.

Offer Stripe products directly from your iOS paywalls and perform checkout flows.

App2Web

Test with your web paywalls by using sandbox products.

Sandbox Purchases

Learn how users can manage their subscriptions from purchases made via the web.

Restoring & Managing Purchases

Frequently asked questions about web checkout.

Web Checkout FAQ

Superwall's recent SDK updates bring several new improvements and features. Here's how to get started quickly.

Using New SDK Features

Learn how to use referral or promo codes with Superwall.

Using Referral or Promo Codes with Superwall

A guide to migrating from RevenueCat to Superwall.

RevenueCat Migration Guide

Use our SDK footprint file, along with a custom Cursor User Rule, to use Superwall with AI.

Using Superwall with Cursor

Creating a Countdown Timer

Building Mult-Tier Paywalls

Managing Connectivity Issues

Learn how to present a unique paywall based on the audience that was matched within a campaign.

Showing Unique Paywalls

Learn how to present a a paywall when a user starts to convert, but then cancels the transaction.

Abandoned Transaction Paywalls

Learn how to present a paywall the moment users interact with your app.

First Touch Paywalls

Learn how to toggle feature gating in a paywall.

Feature Gating

Custom Actions

SuperwallKit 4.0 is a major release of Superwall's iOS SDK. This introduces breaking changes.

Migrating from v3 to v4 - iOS

SuperwallKit 3.0 is a major release of Superwall's iOS SDK, previously known as `Paywall`. This introduces breaking changes.

Migrating from v2 to v3 - iOS

SuperwallKit 2.0 is a major release of Superwall's Android SDK. This introduces breaking changes.

Migrating from v1 to v2 - Android

SuperwallKit 2.0 is a major release of Superwall's Flutter SDK. This introduces breaking changes.

Migrating from v1 to v2 - Flutter

SuperwallKit 2.0 is a major release of Superwall's React Native SDK. This introduces breaking changes.

Migrating from v1 to v2 - React Native

The long-awaited Superwall for Android is now available! Here's how to get started!

Android

Superwall's Flutter SDK is now available — we can't wait for you to try it!

Flutter

The long-awaited Superwall for React Native is now available! Here's how to get started!

React Native

The Overview page gives you a holistic look at how your app is performing, complete with easy-to-find key metrics and top-level campaign data.

Create or edit paywalls across all of your campaigns in one place.

Paywalls

Use our template library to jump-start your paywall design process. Either plug in your products, switch them up to fit your needs, or remix them altogether.

Templates

View charts detailing important metrics about your app's subscription performance, paywalls and more.

Charts

Adding Products

Adding a paywall exit or post-purchase survey is a great way to boost conversion and get feedback on why users declined or purchased from your paywall. Once you've configured a survey, it can be attached to multiple paywalls. A user will only ever see a specific survey once unless you reset its responses.

Surveys

Get a snapshot view of users who recently triggered a placement in your app.

Users

Managing Localization Updates

Creating Applications

GitHub

Twitter

Blog

Sign Up

Status

Superwall can be installed with many different package managers. Please find your preferred package manager below.

Installation

Install the Superwall iOS SDK via Swift Package Manager. To see the latest release, [check out the repository](https://github.com/superwall/Superwall-iOS).

iOS - Swift Package Manager

Install the Superwall iOS SDK via CocoaPods. To see the latest release, [check out the repository](https://github.com/superwall/Superwall-iOS).

iOS - CocoaPods

Install the Superwall Android SDK via Gradle. To see the latest release, [check out the repository](https://github.com/superwall/Superwall-Android).

Android - Gradle

Install the Superwall Flutter SDK via pub package manager. To see the latest release, [check out the repository](https://github.com/superwall/Superwall-Flutter).

Flutter - pubspec.yaml

Install the Superwall React Native SDK via npm or yarn. To see the latest release, [check out the repository](https://github.com/superwall/react-native-superwall).

React Native - Package.json

As soon as your app launches, you need to configure the SDK with your **Public API Key**. You'll retrieve this from the Superwall settings page.

Configuring the SDK

When configuring the SDK you can pass in options that configure Superwall, the paywall presentation, and its appearance.

Passing in options

It is necessary to uniquely identify users to track their journey within Superwall.

User Management

By setting user attributes, you can display information about the user on the paywall. You can also define [audiences](/campaigns-audience) in a campaign to determine which paywall to show to a user, based on their user attributes.

Setting User Attributes

At the heart of Superwall's SDK lies `Superwall.shared.register(placement:params:handler:feature:)`. 

Showing Paywalls

You can toggle particular features to be either gated or non-gated without pushing app updates.

Feature Gating Settings

Feature Gating in Paywall Settings

Placement parameters allow you to send additional data to the Superwall platform when registering placements.

Using Placement Parameters

The `PaywallPresentationHandler` enables you to monitor and respond to key events during paywall presentation, such as when a paywall is displayed, dismissed, encounters an error, or is skipped.

Presentation Handler

Using the Presentation Handler When Presenting Paywalls

There are several ways to view which product was purchased as a result of a paywall presentation.

Viewing Purchased Products

Use this technique to get an instance of a paywall manually, using either UIKit, SwiftUI, or Jetpack Compose.

Retrieving and Presenting a Paywall Yourself

Learn how to present a different paywall from one that's already presented.

Presenting Paywalls from One Another

Superwall is built to handle any networking conditions, from poor network conditions to no network at all.

Handling Poor Network Conditions

Superwall can easily be integrated with 3rd party analytics tools.

3rd Party Analytics

The SDK automatically tracks some events, which power the charts in the dashboard. 

Superwall Events

To easily view Superwall cohorts in 3rd party tools, we recommend you set user attributes based on the experiments that users are included in. You can also use custom placements for creating analytics events for actions such as interacting with an element on a paywall.

Cohorting in 3rd Party Tools

Learn how to log events from paywalls, such as a button tap or product change, to forward to your analytics service.

Custom Paywall Analytics

The full checklist for iOS, Android, and RevenueCat when your products won’t show.

Products Not Loading

Learn how to use the dashboard’s event logs to debug paywall behavior for real users.

How to Debug Paywall Issues in Production

Why free trials sometimes don’t show up in sandbox testing and what to do about it.

Sandbox Free Trial Isn’t Appearing

Fix for when a test transaction seems stuck or active when it shouldn’t be.

StoreKit Transactions Not Clearing in Xcode

Step-by-step checklist when a paywall shows up when it shouldn’t—or doesn’t when it should.

Fixing Unexpected Paywall Behavior

Investigate why your paywall might look like it's using more memory than you expect in Instruments.

Paywall Memory Usage on iOS

Learn why subscriptions behave differently in TestFlight, including identity resets and accelerated renewal schedules.

TestFlight Subscriptions

Use a Superwall delegate to help interface with 3rd party analytics, see which product was purchased on a paywall, handle custom events and more.

Using the Superwall Delegate (Legacy)

It's important to tell Superwall when a deep link has been opened. This enables two things:

Deep Links and In-App Previews

Deep Links and In-App Previews (Legacy)

Custom Paywall Actions (Legacy)

Troubleshooting

Troubleshooting (Legacy)

Pre-Launch Checklist (Legacy)

Use Superwall's best-in-class editor to bring virtually any paywall design to life, complete with advanced U.X. patterns. Or, browse our growing list of paywall templates to get started quickly.

Editor Overview

Getting Started with the Paywall Editor

Layout

Styling Elements

Stacks

Use Superwall's drawer component to display content presented in response to a button tap or a variable changing.

Drawers

Use Superwall's navigation component to navigate through pages of content.

Navigation

Use Superwall's autoscroll component to create marquee-like content that automatically scrolls.

Autoscroll

Use Superwall's slides component to create a horizontal or vertical slide UX driven by a user's gesture.

Slides

Use Superwall's carousel component to have items automatically progress through slides.

Home

SDK

Web Checkout

Guides

Tips

SDK Reference

SDK Quickstart

Dashboard

Recipes