Core Concepts

Plans

Pre-configured subscription templates

Plans are reusable subscription templates that bundle prices together. Instead of selecting individual prices each time you create a subscription, you select a plan and Gilbert sets everything up consistently.

Think of plans as "subscription recipes" — predefined configurations you can apply to new customers.

What's in a Plan?

A plan defines:

  • Currency — All prices in the plan must use this currency
  • Billing duration — The billing interval (e.g., Monthly, Yearly)
  • Prices — One or more prices with default quantities
  • Trial period — Optional trial days for new subscriptions
Currency and billing duration are set when you create a plan and cannot be changed afterwards. To offer the same products with a different currency or interval, create a separate plan.

Creating a Plan

  1. Navigate to Plans in the sidebar
  2. Click Create Plan
  3. Enter a Name (e.g., "Pro Monthly", "Enterprise Yearly")
  4. Select the Currency and Billing duration
  5. Add prices to the plan — Gilbert filters to show only prices matching your selected currency and duration
  6. Set the Quantity for each price (defaults to 1)
  7. Optionally, set a Trial period (e.g., 14 days)
  8. Click Create plan
Only recurring prices that match the plan's billing duration are shown. One-time prices (like setup fees) can be added to any plan regardless of duration.

Plan Structure Examples

Single-Price Plan

The simplest plan includes one recurring price:

PriceTypeQuantity
Starter Subscription — €9/monthRecurring1

Multi-Price Plan

Plans can bundle multiple prices together:

PriceTypeQuantity
Team Subscription — €49/monthRecurring1
Additional Users — €10/user/monthRecurring5

Plan with One-Time Setup Fee

Mix recurring and one-time prices in the same plan:

PriceTypeQuantity
Enterprise Subscription — €99/monthRecurring1
Onboarding Fee — €500One-time1

The one-time fee is charged on the first invoice only.

Plan with Default Trial

PriceTypeQuantity
Pro Subscription — €29/monthRecurring1
Default trial14 days

The default trial is applied when creating subscriptions from this plan. During the trial, the subscription is active but no invoice is generated. Billing starts automatically when the trial ends.

The trial period can be overridden when activating a subscription — you can extend it, shorten it, or skip it entirely.

Plans vs Ad-hoc Subscriptions

AspectPlansAd-hoc
Best forStandard offeringsCustom deals
Setup speedFast — select plan and goManual price selection
ConsistencyGuaranteed same configurationVaries per subscription
Plan changesUpgrade/downgrade supportedManual migration required

When to Use Plans

  • You have standardized pricing tiers
  • Multiple customers get the same configuration
  • You want to offer plan upgrades/downgrades
  • Consistency across subscriptions matters

When to Use Ad-hoc

  • Each customer has unique pricing
  • One-off deals or custom arrangements
  • The configuration won't be reused

Setting Quantities

Each price in a plan has a default quantity (minimum 1):

  • Quantity 1 — Standard for base subscriptions
  • Quantity N — For bundled items (e.g., 5 users included)

Quantities can be adjusted when creating a subscription from the plan.

Plans are templates, not constraints. After a subscription is created, you can freely add or remove prices, and adjust quantities as needed.

Plan Changes

One of the main benefits of plans is easy upgrades and downgrades.

Upgrading or Downgrading

  1. Open the customer's subscription
  2. Click Change Plan
  3. Select the new plan
  4. Choose when to apply the change (immediately or at next renewal)
  5. Confirm

Gilbert handles the transition automatically, including proration calculations.


Managing Plans

Editing a Plan

  1. Navigate to Plans
  2. Select the plan
  3. Make changes (name, prices, quantities, trial period)
  4. Click Save
Editing a plan only affects future subscriptions. Existing subscriptions keep their original configuration.

Archiving a Plan

When retiring a plan:

  1. Create any replacement plans first
  2. Archive the old plan

Archived plans cannot be used for new subscriptions, but existing subscriptions continue unchanged.


Best Practices

Name Plans Clearly

Use names that customers and your team understand:

GoodAvoid
"Starter Monthly""Plan A"
"Pro Yearly""SKU-PRO-Y"
"Enterprise""Tier 3"

Create Plans for Each Interval

If you offer monthly and yearly billing, create separate plans:

  • Pro Monthly — €29/month
  • Pro Yearly — €290/year

This makes plan changes straightforward and keeps pricing clear.

Keep Plans Focused

Each plan should represent one clear offering. Avoid overloading plans with too many optional add-ons — it's better to have focused plans that customers can easily compare.