Upgrade or downgrade your plan

Last updated: May 19, 2026

Upgrade or downgrade your plan

Upgrade: immediate, prorated for the rest of the current cycle, no cooldown. Downgrade: a cooldown window may apply — Wevion shows the next available change date in /settings/team/billing.

Who is this for

Owners and admins changing the active subscription tier. Both upgrades and downgrades happen at /settings/team/billing.

Before you start

  • A clear pick on the new plan (see Wevion plans explained)

  • For downgrades: confirm your current usage fits the smaller plan's quotas — Wevion blocks downgrades that would put you above the new limits

  • For upgrades: ensure your payment method is current (failed charge mid-upgrade rolls back)

How to change plans

Step 1: Open the billing page

Navigate to Settings → Team → Billing. The plan cards section shows your current plan highlighted and the others as "Switch to..." actions.

Step 2: Check downgrade cooldown (if downgrading)

If you're moving down a tier, Wevion checks the plan change cooldown before enabling the button. Behind the scenes: GET /api/v1/billing/plan-change-cooldown returns can_change: false and next_change_at: <ISO date> if you changed plans recently. The UI shows the wait period.

The cooldown only applies to downgrades (price drops). Upgrades and equal-tier changes (e.g. monthly → annual same plan) are always allowed.

Step 3: Click the target plan

Click Switch to [plan name]. A confirmation modal shows:

  • Current plan → New plan

  • What changes: seat allowance, quotas, AI Credits, feature access

  • Billing change: prorated charge or credit for the rest of this cycle, plus the new monthly/annual fee from next renewal

Step 4: Confirm

Click Confirm change. Behind the scenes Wevion calls POST /api/v1/billing/change-plan. Stripe applies the change via subscriptions.update with the new price ID.

Step 5: Wait for activation

The change takes effect within 30-60 seconds (Stripe webhook propagation). Your plan badge updates, quotas refresh, AI Credits adjust.

What proration looks like

Stripe calculates prorations automatically:

  • Upgrade mid-cycle: charges the price difference × days remaining / cycle length

  • Downgrade after cooldown: credits the unused portion of the higher plan + charges the lower plan prorated for remaining days

Net effect appears on your next invoice as line items. During trial: no proration (Stripe param proration_behavior: 'none') — trial credits are preserved.

See billing cycle and prorations for the math in detail.

What changes immediately vs at renewal

Change

When

Plan badge + feature unlocks

Within 30-60s of confirmation

Quotas + seat allowance

Immediate

AI Credits balance

Reset to new plan's monthly pool immediately

Billing interval

At next renewal date

Next charge amount

Next renewal date (full new fee)

Prorated invoice

Generated immediately on Stripe, paid via existing card

What you'll see

After a successful plan change:

  • Plan badge updates (e.g. Starter → Pro)

  • Quota usage bars adjust to new limits

  • AI Credits meter shows the new pool

  • A toast: "Plan changed to [new plan]"

  • An invoice with the prorated amount appears in /settings/team/billing → Invoices

Common issues

  • Button disabled for downgrade: cooldown active. Hover the button for the date. Wait until then or contact support if business-critical.

  • "Cannot downgrade — usage exceeds [plan] limits": you have more seats or connected resources than the lower plan allows. Remove the excess first.

  • Charge looks wrong: check the invoice line items — proration may make the immediate charge smaller than the full new fee.

  • Plan change stuck "Activating...": webhook delay. Refresh after 60s.

  • Annual → monthly switch fails: not usually allowed mid-cycle on annual subs. Wait for renewal and change then, or contact support.

  • Same-tier interval switch (monthly ↔ annual): no cooldown. Effect at next renewal date.

Multiple changes in short succession

Stripe and Wevion handle rapid plan changes correctly, but the cooldown gate prevents downgrade-thrash. Expect at least a 7-day cooldown between downgrades (exact value visible at the cooldown endpoint).

Cancel and resubscribe vs downgrade

Don't cancel-then-resubscribe to bypass the downgrade cooldown. The behaviors are different:

  • Cancel: locks you in read-only at period end, 30d data retention, no refund of unused days

  • Downgrade: keeps access, prorated credit, retain all data

Cancellation is for "stopping", downgrade is for "spending less".

Related