ArcalotlArcalotl
Configuration

Plan Configuration

Advanced plan setup. Billing cycles, trials, multiple plans, and role mapping.

Billing cycles

Plans support monthly and annual billing. The first example creates a monthly plan, and the second creates an annual plan:

/plan create Pro --price 9.99 --role @Premium
/plan create Pro Annual --price 95.88 --role @Premium --interval year

Free trials

Offer a trial period before the first charge:

/plan create Pro --price 9.99 --role @Premium --trial 7

The member gets the role immediately. After 7 days, Stripe charges their card. If the charge fails, the dunning sequence starts.

Multiple plans

You can have as many plans as you want. Common setups:

  • Good / Better / Best: Three tiers at different price points, each with a different role
  • Monthly + Annual: Same tier, two billing options
  • Role stacking: A member can subscribe to multiple plans and accumulate roles

Shared roles

Multiple plans can grant the same role. This is useful for monthly/annual variants of the same tier:

/plan create Pro Monthly --price 9.99 --role @Premium
/plan create Pro Annual --price 95.88 --role @Premium --interval year

Both plans grant @Premium, but at different price points.

On this page