# Plans

> Code Buckets storage plans: Free, Starter, Pro and Business, with storage, public traffic and backups.

Code Buckets has its own storage plans. Each one sets how much you can store across all your buckets, how much public traffic your files can serve each month, and how your buckets are backed up.

<CardGroup cols={1}>
<Card title="Choose a plan" icon="credit-card" href="https://console.clatterlabs.com/storage/plans">Compare plans, see your usage and upgrade in the Console.</Card>
</CardGroup>

## Plans

| | Free | Starter | Pro | Business |
| --- | --- | --- | --- | --- |
| Price | $0 | **$3** / month | **$8** / month | **$20** / month |
| Storage (all buckets) | 2 GB | 50 GB | 250 GB | 1 TB |
| Public traffic per month | 10 GB | 100 GB | 1 TB | 5 TB |
| Backups | 1 manual backup | Daily, newest 7 kept | Daily, kept 30 days | Daily, kept 30 days |
| Manual backups | 1 | Up to 10 | Up to 10 | Up to 10 |
| Team, SLA and priority support | — | — | — | Included |
| Extra usage | Hard limit | With credits | With credits | With credits |

Every plan keeps the same per-bucket and API [limits](/code-buckets/limits): buckets hold up to 10 GB each, and API requests use [tokens](/code-buckets/pricing).


## What counts

- **Storage** is every stored zip and asset in all your buckets, plus uploads you started but haven't completed yet. Deleted files stop counting right away.
- **Public traffic** is the data your [public links](/code-buckets/public-files) send, in a UTC calendar month. Downloads through the API and the Console don't count as traffic (API downloads use [tokens](/code-buckets/pricing)).

## When you reach a limit

On **Free**, and on a paid plan with no credits, the limits are hard:

- An upload that would take you past your storage answers `402 storage_quota_exceeded` with `used_bytes`, `limit_bytes` and an `upgrade_url`. Files you already have stay readable and downloadable; only new uploads are blocked.
- When the month's public traffic is used up, public links answer `429` with a `Retry-After` header until the next month or until you upgrade.

On **Starter, Pro and Business**, you can go past the limits when your account has [credits](/billing/credits). Extra usage is charged from your credits once a day:

| Extra usage | Price |
| --- | --- |
| Storage above your plan | **$0.02** per GB per month, charged per day |
| Public traffic above your plan | **$0.01** per GB |

When your credits run out, the hard limits above apply until you add credits.

## With an AI plan

Your Clatter Labs AI plan also includes storage. Code Buckets uses **whichever is larger**: your AI plan's storage or your storage plan's. Traffic and backups always come from the storage plan.

| AI plan | Storage it includes |
| --- | --- |
| Free | 1 GB |
| Developer | 25 GB |
| Plus | 50 GB |
| Pro | 150 GB |
| Max | 400 GB |
| Ultra | 1 TB |

For example, on the Plus AI plan with the Free storage plan you can store 50 GB, with 10 GB of public traffic a month. Storage plans are billed separately from AI plans.

## Changing plans

Upgrade, switch or cancel in [Console › Storage plans](https://console.clatterlabs.com/storage/plans). Plans renew monthly, and a new plan's limits apply as soon as the payment is confirmed.

Your files are never deleted when you change plans: if you store more than the new plan allows, they stay readable and new uploads are blocked until you're back under the limit.

## Check your plan and usage

```bash
curl https://api.codebuckets.clatterlabs.xyz/v1/usage \
  -H "Authorization: Bearer $CLATTER_API_KEY" -H "X-Clatter-Account: $CLATTER_ACCOUNT_ID"
```

`limits` in the response has your plan, storage, this month's traffic and whether extra usage is allowed. See [Get usage](/api-reference/code-buckets/usage). The Console shows the same numbers on the Code Buckets page and in Storage plans.
