> ## Documentation Index
> Fetch the complete documentation index at: https://getkontext.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Plan changes

> When changes take effect, and how proration works.

One rule covers almost every scenario:

* **Moving up** (higher tier, or monthly → annual) takes effect **immediately**, prorated today.
* **Moving down** (lower tier, or annual → monthly) is **scheduled** to the end of the current billing period.

You never pay for coverage you won't use on an upgrade: the old plan is credited pro-rata. You never lose coverage you already paid for on a downgrade: the scheduled change preserves the current period.

```mermaid theme={null}
flowchart LR
    A[Change plan or cadence] --> B{Direction?}
    B -- "Up (higher tier, or monthly → annual)" --> C[Immediate<br/>prorated today]
    B -- "Down (lower tier, or annual → monthly)" --> D[Scheduled<br/>takes effect at the<br/>end of the current period]
```

## Upgrades, immediate

Examples: Starter → Growth, Growth → Business, Growth monthly → Growth annual.

**Timing.** Applied today.

**Invoice.** Credit for the unused portion of the old plan, charge for the new plan pro-rata to the remainder of the current period, netted on a single invoice issued now.

**Entitlements.** The higher cap, additional seats, and any new feature flags (Business-only custom roles, enforced MFA, audit logs) go live immediately.

**Anniversary date.** It doesn't move.

**From a trial.** An upgrade ends the trial now and charges the new plan pro-rata. That's the "Pick Business" path from [Trial](/docs/billing/trial#picking-the-right-plan-before-day-30).

## Downgrades, scheduled

Examples: Growth → Starter, Business → Growth, Growth annual → Growth monthly.

**Timing.** The change is scheduled to the end of your current billing period. The billing page shows the effective date.

**No refund.** You keep the higher-plan coverage you already paid for, all the way to the last day of the period.

**Changing your mind.** Pick the current plan again to cancel the scheduled change, or pick anything else to replace it. Whatever you pick before the effective date wins.

### Downgrading while over the new plan's cap

This is not blocked. The downgrade lands at period end as normal. The interesting part is day one of the new period:

**If you're already over `included`.** New ingestion stops (the same behavior as any paid org with overages off). Enable overages, or upgrade back, to resume.

**Historical data.** It's always preserved. The cap only gates *new* ingestion.

## Changing billing cadence

| From    | To                  | Timing                         | Money today                                               |
| ------- | ------------------- | ------------------------------ | --------------------------------------------------------- |
| Monthly | Annual (same plan)  | Immediate                      | Credit unused month; charge annual upfront (minus credit) |
| Annual  | Monthly (same plan) | Scheduled → end of annual term | Nothing (no refund of the annual prepayment)              |
| Monthly | Annual higher plan  | Immediate                      | Combined plan + cadence upgrade, prorated today           |
| Annual  | Monthly lower plan  | Scheduled                      | Combined downgrade, effective at end of annual term       |

## Cancellation and the annual commitment

Cancelling does not stop the subscription today. It schedules termination at the end of the current paid period.

**Monthly.** The subscription runs out the current month, then ends.

**Annual.** The subscription runs out the paid year, then ends. **There's no refund of unused months.** The lower effective price on annual is the trade-off for the year-long commitment.

**During the remaining period.** Everything works normally: usage is tracked, members stay active, ingestion runs. Nothing is deleted.

**Changed your mind?** Re-subscribing before the period ends clears the cancellation with no gap.

## Scenarios on one timeline

Each row spans one billing cycle. The left edge is the day you make the change; the red line marks the end of the current paid period; bars past that point are the next period.

```mermaid theme={null}
gantt
    title Monthly subscription
    dateFormat  YYYY-MM-DD
    axisFormat  %b %d

    section Upgrade
    New plan starts today, runs ahead :active, 2026-04-10, 2026-06-10

    section Downgrade
    Current plan keeps running :active, 2026-04-10, 2026-05-10
    New plan starts            :2026-05-10, 2026-06-10

    section Cancel
    Subscription runs to end of period :active, 2026-04-10, 2026-05-10
    Subscription ended :crit, 2026-05-10, 2026-06-10
```

For an annual subscription, the shape of cancellation is the same but the "runs to end of period" bar is up to twelve months long instead of up to thirty days. That's the annual commitment in one picture: you keep what you paid for, and you don't get it back early.

## Summary

| Scenario                               | Timing                                  | Money today                                |
| -------------------------------------- | --------------------------------------- | ------------------------------------------ |
| Upgrade tier                           | Immediate                               | Prorated invoice now                       |
| Downgrade tier                         | Scheduled → end of current period       | Nothing                                    |
| Monthly → Annual (same or higher plan) | Immediate                               | Prorated invoice (credit for unused month) |
| Annual → Monthly (same or lower plan)  | Scheduled → end of annual term          | Nothing                                    |
| Add a seat above included              | Immediate                               | Prorated seat charge on current invoice    |
| Remove a seat that was over included   | Immediate                               | Prorated credit on next invoice            |
| Enable or disable overages             | Immediate                               | Nothing; affects future usage only         |
| Cancel monthly                         | Runs to end of current month, then ends | Nothing                                    |
| Cancel annual                          | Runs to end of paid year, then ends     | Nothing (no refund)                        |

Plan and cadence changes live under **Organization Settings → Billing**. Invoices, receipts, and payment methods are in **Manage billing**.
