Organization Subscriptions
Organizations can subscribe to a shared plan so that all members benefit from the same features and limits.
How Organization Plans Work
Organization subscriptions use the same plans as individual subscriptions (Starter, Basic, Professional, Unlimited). The key difference is that limits are pooled across all organization members.
Plan Fallback Logic
When determining a user's plan, the system checks in this order:
- Personal paid plan — if the user has their own active subscription, that takes priority
- Organization plan — if the user is in an org with an active subscription and has no personal paid plan, the org plan is used
- Free plan — default fallback
This means a user with a Professional personal plan will keep their own limits even if their org has a Starter plan.
Pooled Limits
When using the org plan, limits are shared:
- Link limits — total links created by all org members count toward the org plan's monthly limit
- Storage — total storage used by all org members counts toward the org plan's storage quota
- File size — individual file uploads follow the org plan's max file size
Subscribing
- Go to Organization in the sidebar
- Find the Organization Plan card
- If no subscription exists, you'll see plan options with pricing
- Select a plan and billing interval (monthly or annual)
- Click Subscribe to start Stripe Checkout
- After payment, you're returned to the Organization page with
?subscribed=true - The subscription activates — if the Stripe webhook hasn't fired yet, a fallback checks Stripe directly
Usage Dashboard
Once subscribed, the Organization Plan card shows:
- Plan name and billing interval
- Links progress bar — used / limit (aggregated across all members)
- Storage progress bar — used / limit (aggregated across all members)
- Manage Billing button — opens Stripe Customer Portal
Managing the Subscription
Click Manage Billing to access the Stripe Customer Portal where you can:
- Change to a different plan (upgrade or downgrade)
- Switch between monthly and annual billing
- Update payment methods
- Cancel the subscription
Only the organization Owner or Admin can manage the subscription.
API Endpoints
| Endpoint | Description |
|---|---|
GET /api/organization/{orgId}/checkout?plan=X&billing=Y |
Create Stripe Checkout session |
GET /api/organization/{orgId}/portal |
Redirect to Stripe billing portal |
GET /api/organization/{orgId}/subscription |
Get subscription status and usage |
POST /api/organization/webhook |
Stripe webhook for org subscription events |