Skip to content

Subscriptions Overview

Subscriptions let you gate content behind paid access tiers. Billing is handled by Stripe — your platform handles entitlement enforcement based on the active subscription.

Subscriptions must be enabled in Admin → Platform Config.

How it works

  1. You define tiers in Admin → Subscription Tiers and map each one to a Stripe product
  2. You assign a tier to content nodes that should be restricted
  3. A viewer who wants to watch gated content is taken to a checkout page powered by Stripe
  4. Once payment is confirmed, Stripe notifies your platform and the viewer's account is upgraded to the corresponding tier
  5. The viewer can now access all content assigned to that tier

Tier hierarchy

Access is controlled by the weight field on each tier's benefits. A viewer can watch any content gated to a tier whose weight is equal to or lower than their own tier's weight.

This means you can model a natural upgrade path — for example:

TierWeight
Basic1
Standard2
Premium3

A Premium subscriber (weight 3) can access all Basic and Standard content without those tiers being explicitly assigned to them. A Basic subscriber (weight 1) can only access content assigned to Basic.

Content with no tier assigned is accessible to any logged-in viewer regardless of weight.

Free content

Content nodes with no tier assigned are accessible to any logged-in viewer regardless of subscription status. This is useful for trailers, sample episodes, or introductory content.

Concurrent stream limit

Each tier can have a maximum concurrent stream count — the number of devices that can watch simultaneously under one account. This is configured per tier in Admin → Subscription Tiers.

Cancellations and downgrades

When a viewer cancels or their subscription lapses, Stripe sends a webhook and the platform immediately removes their access to gated content. Their account, watchlist, and viewing history are preserved.

Stripe setup

See Managing Tiers for step-by-step Stripe configuration.