<!-- Canonical: https://startupmail.dev/docs/usage-limits -->
<!-- Documentation index: https://startupmail.dev/llms.txt -->

# Usage and limits

> Understand email events, storage, recipient and attachment limits, and workspace safety caps.

## Included capacity

The launch plan includes one mailbox, 1 GB of storage, and 1,000 email events each month. Yearly billing is $12 per mailbox; monthly billing is $2 per mailbox. The product UI shows the current included capacity and billing state for the workspace.

A stackable $5 monthly capacity pack adds 5 GB storage, 5,000 monthly events, 50 inboxes, 5 domains, and 5 organization seats.

## What counts as an event

- One accepted incoming mailbox delivery is one event.
- Each outbound recipient is one event.
- Each forwarded copy is one event.
- Rejected spam, quarantined mail, and duplicate provider events are not billed.

## Message limits

| Limit              | Current boundary          |
| ------------------ | ------------------------- |
| To recipients      | 10 per message            |
| CC recipients      | 10 per message            |
| BCC recipients     | 10 per message            |
| Subject            | 240 characters            |
| Plain or HTML body | 250,000 characters each   |
| Attachments        | 10 per message            |
| Single attachment  | 5 MB                      |
| Complete message   | 10 MB configured boundary |

## Sending caps

New workspaces use conservative daily sending limits. Monthly event limits and daily outbound limits are checked before a message is queued. A request that exceeds a cap returns `429` with a specific error code such as `monthly_limit` or `daily_limit`.

Rate limiting can also return `429` when too many send requests arrive in a short window. Use bounded backoff and do not create an uncontrolled retry loop.

## Billing state

A workspace can be trialing, active, past due, or inactive. Expired trials and inactive subscriptions cannot send. Incoming mail remains available when outbound sending is paused for delivery reputation review.
