Skip to content

Paywalls

Paywall rules determine which content is gated and how.

Rules are evaluated in ascending priority order. The first matching rule wins.

TypeBehavior
MeteredAllow N free views, then deny
HardDeny unless the user has a matching subscription
RegistrationDeny unless a userId is present
SoftGrant access and return a paywall hint

The current dashboard form primarily exposes URL-based conditions.

Available URL operators are:

  • contains
  • matches
  • eq

The access engine also supports has_user and segment_id, but the current UI focuses on URL matching.

Each rule stores:

  • productIds
  • optional message
  • optional meterLimit
  • optional template (modal, bottom-bar, inline)

Rules can be toggled active or inactive without deleting them.

Soft paywalls return granted: true. If you want a visible prompt for soft rules, your integration should inspect the returned paywallRule and render the prompt itself.