Subscription Packages

A subscription package is the marketing-facing offer: a name, a price, a billing cadence, and a feature set. Packages are what customers pick on your pricing page.

Package Anatomy

• Name — what customers see (“Pro”).
• Price — amount and currency (£30 GBP).
• Billing cadence — monthly, annually, one-off.
• Feature set — what the customer gets.
• Limits — user count, record limits, storage, etc.
• Trial period — optional days of free access.
• Promotion — “most popular” badge, “save 20%” callout.

Typical Catalogue

• Free — limited, no card required, conversion engine.
• Starter — small business, single user, basic features.
• Pro — growing team, up to 10 users, integrations.
• Business — established teams, up to 50 users, audit log, white-label.
• Enterprise — custom quote, unlimited users, SSO, dedicated support.

Worked Examples

• B2B SaaS: Five packages — Free, Starter, Pro, Business, Enterprise. Annual billing offered at -20% to push longer commitments.
• Marketplace platform: Two packages — Buyer (free) and Seller (£20/mo + 5% transaction fee).
• Educational platform: Three packages — Student (£5/mo), Teacher (£15/mo), School (£500/mo). Student plan requires .edu email.
• Membership site: Four packages by duration — Monthly, Quarterly, Annual, Lifetime.

This article walks through creating a new subscription package, linking it to the right feature set and pricing it for billing.

Step-by-Step

1. Open Architect Panel → Subscription Packages and click New Package.
2. Enter the name and slug. The slug shows up in URLs and Stripe metadata.
3. Write a short description (a paragraph) — used in the marketing site's tier card.
4. Set the price and currency. For multi-currency, you create a separate price per currency under Prices tab.
5. Pick the billing cycle — monthly, annual, one-off. Add a second cycle if you offer both with a discount.
6. Choose the feature set this package unlocks.
7. Set limits — user count, records, storage. These are also passed to Stripe metadata for enforcement.
8. Optional: trial days (e.g. 14 days free) — Stripe handles the timer.
9. Decide visibility — visible on the pricing page, available by direct link only, or admin-only.
10. Save and test by signing up a dummy customer through the regular flow.

Linking to Stripe

On save, the platform creates a matching Stripe Product and Price (or set of Prices) so that Stripe's subscription engine handles renewals. If you update price or features later, the platform syncs the change to Stripe automatically.

Worked Examples

• Yearly with discount: Pro package has two prices — £30/mo or £288/year (a 20% saving). Both tied to the same feature set.
• Multi-currency: Same Pro package priced at £30 GBP, $39 USD, €34 EUR.
• Educational discount: Same feature set as Pro but priced £15/mo, with eligibility verified by .edu email at checkout.
• Free trial: Business package has 14 trial days; Stripe doesn't charge until the trial ends.

A subscription belongs to a tenant — and the tenant gets the package's features. This article covers how that link is established and managed.

How the Link Forms

• Self-service signup: A new tenant is created during checkout; the subscription is attached at the moment of payment.
• Admin assignment: Admin manually grants a tenant a subscription (useful for migrations, beta partners, gifts).
• API: A provisioning system creates tenant + subscription together.

Viewing and Changing

Open Architect Panel → Tenants, click the tenant, then the Subscription tab. You can:

• See current plan, renewal date and next invoice amount.
• Change plan immediately or at next renewal (proration handled by Stripe).
• Apply a discount code retrospectively.
• Pause or cancel.
• View full history of plan changes for audit.

Worked Examples

• Upgrade to Pro: Customer clicks Upgrade in the app. Plan changes immediately, prorated charge appears on next invoice.
• Downgrade to Free: Customer downgrades; the platform delays the actual change until the end of the current billing period so they get what they paid for.
• Admin grants Business: A partner gets a complimentary Business plan. Admin clicks Change plan, no charge applied.
• Acquisition migration: 200 acquired customers migrated; each tenant created with subscription set to “Legacy Pro” at a grandfathered price.

Note: If a tenant has multiple subscription packages (e.g. a base plan plus add-ons), each is its own subscription with its own renewal date. The tenant gets the union of features from all active subscriptions.