ArcalotlArcalotl
Configuration

Plan Configuration

Configure tiers, billing options, Discord roles, and plan lifecycle behavior.

Plan model

Arcalotl uses tiers and billing options:

  • A tier is what members see, such as Pro or VIP.
  • A billing option is how that tier is billed, such as monthly or annual.
  • A Discord role is the access granted when a subscription becomes active.

Billing options

Plans support monthly and annual billing.

/retain plan create

The Discord create-plan flow asks for a monthly price and an optional annual price. The dashboard supports the same structure when creating or editing plans.

If you add both monthly and annual billing to a tier, the annual price must be lower than 12 monthly payments.

If you already have Stripe products and prices, use Import Plans to link them to Arcalotl.

Role mapping

Each tier can grant a Discord role. Members receive the role when Stripe confirms the subscription and lose it when access ends.

Discord only lets a bot manage roles below its own highest role. Put the Arcalotl bot role above every paid role.

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

Current limits

  • Trial setup is not exposed in public plan creation yet.
  • Supported intervals are monthly and annual.
  • Term optimization requires a monthly option and an annual option on the same tier.
  • Annual pricing must be cheaper than 12 monthly payments when both options exist.

Plan lifecycle

Archive plans you no longer want to sell. Existing subscriptions keep following their Stripe subscription state, while new members can no longer choose the archived plan.

Use Community Channels when you want a dedicated Discord channel that displays active plans with Subscribe buttons.

On this page