DocumentationREST APISamplesSDK ReferenceBlogSuggest an EditGet Help
Sign upLog in

RevenueCat's Paywalls allow you to remotely configure your entire paywall view without any code changes or app updates. Whether you’re building a new app, exploring new paywall concepts, or diving into experimentation; RevenueCat’s Paywalls make it easy to get started.



Paywalls are available on the following platforms:

  • iOS 15.0+

  • visionOS 1.0+

  • Mac Catalyst 15.0+

  • watchOS 8.0+

  • Android 7.0 (API level 24)

Support for more platforms is coming soon: macOS, tvOS, and others!



# How Paywalls work

## iOS Installation

### Using SPM:

#### If you already have `RevenueCat` in your project:

  1. Open your project settings and select "Package Dependencies": <img width="783" alt="Change version" src="https://github.com/RevenueCat/purchases-ios/assets/685609/d317fd33-8270-4d9b-9b38-8f5f14342b04">

  2. Double-click and make sure version is at least `4.26.0`: <img width="400" alt="Configure version" src="https://github.com/RevenueCat/purchases-ios/assets/685609/f537a1e1-a1ab-4e6f-986c-05abdcf1dd9f">

  3. Open your target settings and find "Frameworks, Libraries, and Embedded Content": <img width="328" alt="Find frameworks in your target" src="https://github.com/RevenueCat/purchases-ios/assets/685609/af078e9a-4b98-42c6-8ca7-6f79aebdf3e0">

  4. Add `RevenueCatUI`: <img width="512" alt="Add RevenueCatUI dependency" src="https://github.com/RevenueCat/purchases-ios/assets/685609/c2a3498c-b80d-405c-bdf6-75de927ea58e">

#### First time integrating the RevenueCat SDK:

  1. Click File -> Add Packages...

  2. Search for `[email protected]:RevenueCat/purchases-ios.git` and make sure version is at least `4.26.0`: <img width="1196" alt="Adding purchases-ios dependency" src="https://github.com/RevenueCat/purchases-ios/assets/685609/18291043-5710-4944-ba12-7d6d83bde240">

  3. Add `RevenueCat` and `RevenueCatUI` SPM dependency to your project: <img width="400" alt="Add paywall" src="https://files.readme.io/9140485-Screenshot_2023-08-04_at_12.08.07.png">

### Using CocoaPods:

Add the following to your `Podfile`:


## Android Installation
  1. Add `RevenueCatUI`:


Android paywalls is currently behind an experimental flag (`ExperimentalPreviewRevenueCatUIPurchasesAPI`).
It is safe to release app updates with it. We guarantee that paywalls will continue to work and any changes will always be backwards compatible.
They are stable, but migration steps may be required in the future. We'll do our best to minimize any changes you have to make.
## Overview
Our paywall templates use native code to deliver smooth, intuitive experiences to your customers when you’re ready to deliver them an Offering; and you can use our Dashboard to pick the right template and configuration to meet your needs.
To use RevenueCat Paywalls, simply:
  1. [Create a Paywall](🔗) on the Dashboard for the [Offering](🔗) you intend to serve to your customers
  2. See [displaying paywalls](🔗) for how to display it into your app.

RevenueCat Paywalls are available on the following SDK versions:
  • iOS: version >= 4.26.0
  • Android: version >= 7.1.0
## Offerings and Paywalls
You can think of a Paywall as an optional feature of your Offering. An Offering is the collection of Products which are organized into Packages to be displayed to your customers as a single "offer" across platforms. Now, with Paywalls, you can control the actual view that is used to display that "offer" in addition to controlling the products that are offered.
Therefore, you can create a unique Paywall for each of your Offerings, and can create an unlimited number of Offerings & Paywalls for each variation you want to test with Experiments.
# Limitations
## Platforms (support for more coming)
  • ✅  iOS 15.0 and higher
  • ✅  visionOS 1.0 and higher
  • ✅  Mac Catalyst 15.0 and higher
  • ✅  watchOS 8.0 and higher
  • ✅  Android 7.0 (API level 24)
  • ❌  macOS
  • ❌  tvOS
## Android's Google Play developer determined offers
Paywalls in Android will use the default subscription option which, in case you use [developer determined offers](🔗), will always be available, providing these types of offers always to your users. If you want to avoid this behavior when using paywalls, add the `rc-ignore-offer` tag to the developer determined offer from your product.
# Next Steps
  • Now that you know how our paywalls work, read about [creating paywalls](🔗)
  • Once you're ready to see your paywalls in action, you can follow our guides on [displaying paywalls](🔗)
  • If you need inspiration with some paywall examples, you can try our [Paywalls Tester app](🔗)