ArcalotlArcalotl
Getting Started

Create Plans

Set up subscription tiers with pricing, billing options, and Discord roles.

Plans are the subscription tiers your members can buy. A tier can include a monthly billing option, an annual billing option, or both. Each billing option can grant the same Discord role.

When a member subscribes, Arcalotl grants the configured role. When access ends, Arcalotl removes it.

Create a plan from Discord

Run:

/retain plan create

Discord asks you to choose the role that subscribers should receive. Arcalotl then opens a modal for:

  • Plan name
  • Monthly price
  • Optional annual price
  • Currency

The monthly option is the primary setup path. Add an annual option when you want term optimization to offer monthly subscribers a prepaid annual upgrade.

Arcalotl can only grant roles below its bot role in Discord's role hierarchy. Move the Arcalotl bot role above your paid roles before creating plans.

Billing options

Supported intervals:

IntervalUse it for
monthStandard monthly subscriptions
yearAnnual subscriptions and term optimization offers

If a tier has both monthly and annual pricing, the annual amount must be lower than 12 monthly payments. For example, a $10 monthly plan can have a $96 annual option, but not a $120 annual option.

Create and manage plans from the dashboard

The dashboard supports the same tier model. You can create a tier, add monthly and annual billing options, assign the Discord role, update plan names and prices, and archive plans you no longer sell.

See Dashboard Plans for the dashboard behavior.

Discord plan commands

  • /retain plan create: Create a new tier and billing options.
  • /retain plan edit: Edit an existing plan.
  • /retain plan delete: Archive a plan so new members cannot buy it.
  • /retain plan list: View current plans.
  • /retain plan import: Import existing Stripe products and prices.

Use Import Plans when you already have Stripe products and prices.

Current limits

  • Trial setup is not exposed in plan creation yet.
  • Only monthly and annual billing intervals are supported.
  • Annual upgrade offers require an annual billing option on the same tier.
  • Use Community Channels to show active plans in a dedicated Discord channel.

On this page