Skip to content
Verified

Proration, upgrades and downgrades

What happens the moment you confirm a plan change, and what it means for your next bill.

Every plan on your account, membership, support, AI Workspace, and every module, is its own item on the consolidated subscription. Changing one only ever reprices that one item, and what happens next depends on whether the change is an upgrade or a downgrade.

Upgrades: charged now, prorated for what is left of this cycle

You confirm the new plan

The screen has already shown you a preview: the exact amount due today, and what the plan renews at.

The charge is computed for the rest of the current cycle only

Xuda asks Stripe for what the remainder of this billing period would cost at the new plan's price, crediting back the unused part of what you already paid for the old one. Your renewal date does not move.

The card on file is charged immediately

The prorated difference is charged the moment you confirm, and the new plan is active right away.

The preview and the charge are computed the same way, on purpose

stripe_get_proration (the preview) and stripe_update_plan (the actual charge) resolve the same subscription item and the same price for the plan, so the number you are shown before confirming is the number that gets charged. A promo code you apply changes what the plan renews at going forward; it is never subtracted from today's prorated charge.

Your first paid plan starts a new billing cycle

A new account holds only free plans, and its billing cycle starts the day it signs up. Nothing is prorated against that cycle: when the account moves to its first paid plan, whether that is Pro two weeks after signing up, a paid Support or AI Workspace plan, or the first paid plan of a module, billing starts over that day.

  • The plan's full first month is charged the moment you confirm.
  • Your billing date moves to that day, and the plan renews on it every month after.
  • The preview says both before you pay: the full amount due today, and the date it renews.

This applies while every plan on the account is free and no plan has been paid for the current cycle. Usage billed on the last renewal (hosting time, calls, storage past the allowance) does not count as a paid plan. Once a plan is paid, the next upgrade is prorated as described above and keeps that billing date.

Anything the cycle that ends that day still had pending, such as usage added up before a renewal, is on the same payment as the plan: the preview shows it as Usage to date in the amount due today, and it is charged to the card you pick at checkout. If that card is declined, nothing is charged and the usage stays pending for the next attempt or the next renewal. Hosting time is billed in arrears from where it was last billed, so it is never charged twice and never skipped.

The newsletter's 10% code, typed at checkout, comes off this first month only. The renewal a month later is at the plan's full price.

Downgrades: scheduled for the end of your current cycle

A downgrade never charges you today and never takes your current plan away early. Instead, it is scheduled to take effect at the end of the billing period you have already paid for:

You confirm the lower plan

Nothing is charged. The preview shows $0 due now and the date the change takes effect.

The change is scheduled, not applied

A two-phase schedule is set on your subscription: your current plan continues exactly as it is until the period ends, then the item switches to the lower plan's price for the next cycle onward.

Your plan changes on the date shown, automatically

No further action is needed. The switch happens on schedule, and normal renewal continues from there.

While a downgrade is pending, the plans screen shows a Scheduled badge naming the plan you are moving to and the date it takes effect, with a Cancel action right there: cancelling releases the schedule and leaves you on your current plan, renewing normally.

A new change replaces a pending one, it does not queue behind it

Confirming another plan change while a downgrade is already scheduled cancels that pending change first. Upgrading while a downgrade is pending applies the upgrade immediately, the same as any other upgrade; scheduling a different downgrade replaces the one already queued.

Switching a module off vs. downgrading it to Free

Both use the same scheduled-change mechanism described above and both leave the module running unchanged until the period ends. The difference is only in what the module looks like afterward: a plain downgrade lands the module on its Free tier, on, with the Free tier's own limits; switching a module off entirely carries that intent through the same schedule so the module lands off rather than on at Free.

Why a downgrade can be refused

A module refuses a downgrade that would leave more in use than the lower tier allows, rather than silently landing you over its limit at the transition. Commerce, for instance, refuses a downgrade that would strand more published products than the new tier includes; Drive refuses moving back to Free while the account is storing more than Free would leave it. The refusal names what is over the new tier's limit, so the fix is always to bring usage down first, then try the change again.

The member perk on AI Workspace

While your membership is on any paid tier, the AI Workspace plan you are on is billed at 10% off its standard price. The discount applies and clears automatically as your membership changes, with no action needed: it follows your membership's status, not a coupon you have to reapply.

Billing currency and plan prices

A plan's price is read in your account's own billing currency at the moment a change is previewed and charged, so what you are quoted is always what gets charged, in the currency you actually bill in. See Invoices and payment methods for how that currency is chosen and how it can be changed.