CommetCommet
GitHubDiscordStatus
Introduction

Quickstart

Create an API KeyQuickstart

Learn

Manage SubscriptionsGrant Temporary Plan AccessUpgrade and Downgrade Plans

Resources

SDK ReferenceAPI VersioningError HandlingTestingCLIExamples

Plugins

Better Auth
DocumentationKnowledge BaseBuild with AIAPI ReferenceWebhooks

Upgrade and Downgrade Plans

How customers change plans through the Customer Portal and dashboard.

Customers change plans through the Customer Portal or from the dashboard. Commet handles proration, feature transitions, and billing adjustments automatically.

Plan change behavior

ChangeBehaviorExample
UpgradeApplied immediately with prorated billingStarter ($29) → Pro ($99)
DowngradeTakes effect at next renewalPro ($99) → Starter ($29)
Interval change (up)Applied immediatelyMonthly → Yearly
Interval change (down)Takes effect at next renewalYearly → Monthly

Both plans must be in the same Plan Group for customers to change plans themselves through the portal. Free-to-paid changes require a new checkout — the customer is redirected to complete payment.

An immediate upgrade is rejected with a seat-limit error when the customer's current seats exceed the target plan's included seats for a seat feature that is not unlimited and has overage disabled. Reduce seats first, or pick a plan with enough included seats. Interval-only changes and scheduled downgrades are not affected.

If you need to expand features or limits temporarily without changing the subscription's plan, price, or billing cycle, use a Plan Grant instead.

Dashboard

From a customer's subscription detail page, click Change Plan and select the new plan. The same upgrade/downgrade rules apply.

Learn more

  • What Happens When a Customer Changes Plans
  • How Is Proration Calculated

Related

  • Manage Subscriptions — Create, get, and cancel subscriptions
  • Plan Groups — Group plans together for self-service upgrades
  • Customer Portal — Self-service billing portal for customers

How is this guide?

Grant Temporary Plan Access

Temporarily expand a subscription's features and limits without changing its plan, price, invoice, or billing cycle.

Track Usage

Record metered consumption with the current Commet SDKs.

On this page

Plan change behavior
Dashboard
Learn more
Related