Managing Membership Tiers
AdminMembership tiers control which content users can access. Each tier represents a level of access, and tiers are linked to Stripe prices for automated billing.
Tier Hierarchy
PATHS ships with four default tiers, seeded via the foundation seed:
| Tier | Access Level | Description |
|---|---|---|
| Free | 1 | Basic access to free articles and course previews. |
| Regular | 2 | Access to standard courses and articles. |
| Premium | 3 | Full access to all content including premium courses. |
| Enterprise | 4 | Organization-level access with all premium features. |
Access level numbers
Content is gated by numeric access level. A user with tier level 3 (Premium) can access all content with access level 3 or below. Higher numbers mean more access.
Creating or Editing a Tier
price_1abc...) from your Stripe dashboard.Price IDs are required for billing
Without valid stripeMonthlyPriceId and stripeYearlyPriceId values, the checkout endpoint will return a 400 error when users try to subscribe to that tier. Always configure these after creating a tier.
Linking Tiers to Stripe
Each tier needs corresponding products and prices in your Stripe dashboard:
- Create a Product in Stripe for each tier (e.g., "PATHS Regular Plan").
- Add two Prices to each product: one monthly recurring, one yearly recurring.
- Copy each price's ID (
price_...) and paste it into the corresponding tier fields in PATHS.
How Tier Assignment Works
Manual assignment
Admins can assign tiers directly on a user's record via the Users collection. Open the user, select the desired tier from the dropdown, and save.
Automatic via Stripe
When a user subscribes via Stripe checkout, the webhook updates their tier automatically based on the price ID. No admin action is needed.
Automatic downgrade
When a subscription is canceled or expires, the webhook reverts the user to the Free tier automatically. No admin action is needed.
Next Steps
Learn how to set up organizations in Managing Tenants.