RevenueCat Paywalls is the easiest way to build custom paywalls for your app. Combined with RevenueCat Targeting, it allows you to serve a different paywall to different customers without having to make new releases. With the release of the new Paywall Rules feature you can take personalized paywalls even further, without having to make new paywalls.

Hides components when a package is selected, and more

Paywall Rules allow you to customize the visibility of paywall components based on both preset and Custom Variable based rules. This allows you to customize a single paywall to support multiple scenarios.

Example cases of using Paywall Rules could be for example showing a trial timeline only when a trial is available or showing a different package based on a custom variable.

Paywall Rules support the following rules at the moment:

RuleWhen the rules will take effectWhat Rules are available
offer.introIf the user selects a package that includes an introductory offerVisibility and text overrides
offer.promoIf the user selects a package that includes a promotional offerVisibility and text overrides
package.identifierIf the user selects a package that matches the defined identifierVisibility only
Custom variableIf the paywall is rendered with or without the defined custom variable.Visibility only
offer.multiphaseIf the user selects a package that includes a promotional offerText overrides only

Create your first Paywall Rule

To create a Rule for your paywall, navigate to paywall editor and select the Paywall logic tab from the left sidebar. You will see the following button to create a new rule:

Screenshot of RevenueCat Paywall logic tab, showing Create Rule button

Creating a rule has two parts:

  1. Selecting the Rule that will control component visibility
  2. Selecting either existing or new components that the rule will be applied to
Screenshot of Paywall editor and Paywall Rule tab, showing new offer.intro rule that demermines if a selected package is shown if there's an introductory offer available for the user.
A purple highlight around the preview indicates that you’re viewing how paywall look like with Rule applied.

When viewing your rule, any component that you add will be set to only be visible for that Rule. You can edit this later if you require the component to be visible in more cases.

Rules are evaluated at runtime, after publishing your paywall, which allows multiple rules to exist on a component. Rules are applied to a component in the order defined in the table above. Custom variable rules are evaluated in alphabetical order.

Current limitations of Paywall Rules

Paywall Rules are supported on most components that you can add to your paywall, with the following limitations:

  • Express checkout buttons
  • Individual pages of a carousel
  • Individual tabs
  • Footer
  • Sheet
  • Purchase Button

Conclusion

Paywall Rules make it easier than ever to build smart, context-aware paywalls without the overhead of maintaining multiple paywall variants. Whether you want to highlight a trial offer only when one is available, swap out packages based on a custom variable, or tailor messaging for promotional offers, a single paywall can now handle it all. As we continue to expand the supported components and rule types, we’re excited to see the creative ways developers and growth teams use this feature to drive conversions. Give Paywall Rules a try and let us know what you think.

Paywall Rules documentation