highRevenueCat Blog·April 17, 2026

Announcing Paywall rules: show or hide paywall components

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:

Creating a rule has two parts:

Selecting the Rule that will control component visibility

Selecting either existing or new components that the rule will be applied to

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:

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

Key Insights

1

Dynamic paywall personalization reduces friction in conversion flows by contextually displaying relevant offers

2

Rules-based paywall customization enables A/B testing and segmentation without rebuilds, improving conversion rate optimization workflow

3

Custom variables support allows targeting based on user attributes, enabling data-driven paywall optimization

Announcing Paywall rules: show or hide paywall components | ASO News