Skip to main content
Your customers can switch between plans in the same plan group through the Customer Portal. The group’s sortOrder defines upgrade and downgrade direction; Commet does not infer it from price.

​
Upgrades

When the billing interval stays the same, moving to a plan with a higher sortOrder is an immediate change. The customer is charged the new plan’s full price, credited for the unused days of the old effective base price, and their billing cycle restarts on the day of the change.
An upgrade is blocked if the customer already uses more seats than the new plan includes, when that seat feature has overage disabled. They have to remove the extra seats first, or choose a plan with enough included seats.

​
Example

​
Downgrades

When the billing interval stays the same, moving to a plan with a lower sortOrder is scheduled at renewal. The customer keeps the current plan and features until the end of the paid period, then switches.
Your customer already paid for this period. They keep full access until it expires — no partial refunds, no disruption.

​
Free to Paid

When your customer moves from a free plan to a paid plan, the change is always immediate. There’s no credit to issue since the free plan costs $0, so they pay the full price of the new plan.

​
Example

​
Changing Billing Frequency

Intervals go from shortest to longest: weekly, monthly, quarterly, semiannual, yearly. Interval direction takes precedence over sortOrder when both the plan and interval change. A paid-to-free change is always scheduled, even if the destination plan has a higher sortOrder.

​
Deprecating a Plan

When you deprecate a plan, it disappears from your pricing page, dashboard, and portal — but your existing customers keep it. Their billing continues normally. If they cancel, they won’t be able to come back to that plan.

​
Deleting a Plan

Deleting a plan is a soft delete. The plan disappears from your pricing page and can’t be assigned to new customers — but existing subscriptions are unaffected and keep billing normally.

​
Reactivation

A canceled subscription can be reactivated — from the dashboard, the API, or the Customer Portal. Reactivation generates a fresh invoice at the plan’s current price, charges the saved card, and starts a new billing period on the reactivation date. If the charge is declined, the subscription stays canceled and your customer gets a link to update their card. If the cancellation is only scheduled for the end of the period, your customer can undo it in the portal before it takes effect.
If the plan is no longer available, reactivation is rejected — your customer starts a new subscription on a different plan.

​
Feature Changes

Feature changes use the current-period subscription snapshot:

​
Example