# Usage, size limits, and retention

The dashboard and `GET /api/usage` show your account's plan, monthly accepted-message allowance, domain and exact-address route limits, storage usage and quota, and current retention. API keys require `usage:read`. Your exact plan limits and billing availability are shown in the account.

## Plans and included limits

| | Free | Starter | Growth |
| --- | ---: | ---: | ---: |
| Monthly price | €0 | €20 | €49 |
| Custom domains | 1 | 3 | 10 |
| Accepted messages per UTC month | 10,000 | 30,000 | 100,000 |
| Maximum complete raw email | 5 MiB | 25 MiB | 25 MiB |
| Retained storage capacity | 5 GB | 50 GB | 150 GB |
| Maximum content retention | 7 days | 30 days | 60 days |
| Exact-address routes | Not included | Unlimited | Unlimited |

Paid prices are per month, before applicable tax. All three plans include a hosted test address separate from the custom-domain allowance, domain catch-all routing, signed webhooks, and delivery history. Automatic retry and manual replay require positive retention and available content.

Every plan lets you choose 0 days or any whole number up to its maximum retention. A new account starts at its plan maximum. One MiB is 1,048,576 bytes. One GB is 1,000,000,000 bytes. Storage is a capacity limit on content retained at one time.

## Message and storage limits

An accepted inbound message counts once for your account, even when several addresses in that account receive it. A separately accepted SMTP retransmission counts as a new message. Delivery attempts, replay, and synthetic webhook tests do not count as accepted inbound mail. Allowances reset at 00:00 UTC on the first day of each month. Unused messages do not roll over, and Wildmail does not charge automatic message overages.

The maximum message size includes the complete raw email: headers, body parts, MIME boundaries, encoded attachments, and line endings. The dashboard shows the current per-message limit. An oversized message is rejected, so the sender must reduce its size. Exhausting monthly message or storage capacity temporarily refuses new mail. The sender can retry after capacity becomes available.

The Usage page reports used and remaining storage capacity. Retained content uses that capacity until expiry and cleanup complete. The dashboard displays the current domain and exact-address route limits for your plan.

## Choose account retention

Open **Settings** to choose 0 days or a whole number of days up to your plan maximum. The initial setting uses the plan maximum. Updating retention applies to messages already stored in your account and to future inbound mail. Wildmail also checks the current policy before showing message content, downloading raw mail or attachments, retrying delivery, or replaying an event.

With positive retention, message content and attachments remain available until their expiry under the current setting. Retry and replay stop when the content is no longer available. Extending retention can keep existing content available longer if it has not already been deleted. It cannot restore deleted content.

With **0 days**, Wildmail allows at most one webhook attempt and includes attachment bytes inline as base64. Automatic retry and replay are disabled. Content is kept only for delivery and has a 24-hour safety deadline if the message never reaches an attempt. When changing retention to 0 days, completed or previously attempted messages are purged. Eligible messages that have not been attempted can receive at most one attempt before cleanup. The event outcome and content-free delivery history remain after message content is removed.

## Message downloads

The dashboard opens in **Threads** view. Switch to **Individual messages** to inspect each receipt or its expired delivery history. Search and delivery-status filters carry across views, and switching resets pagination. Threads show retained messages only, oldest first on the thread page, with links to each message's preview, attachments, downloads, and delivery history. Counts shrink as members expire. Accounts using 0-day retention have no browsable threads. The API provides the same retained view through `GET /api/threads` and `GET /api/threads/{id}` with `messages:read`.

Use `GET /api/messages` and `GET /api/messages/{id}` to find and inspect retained mail. A message detail response can include a raw-message link and parsed message fields while content is available. Attachment descriptors contain stable Wildmail URLs in normal retention mode. Download an attachment from `GET /api/messages/{id}/attachments/{attachmentId}` with an account API key that has `messages:read`, or through the signed-in dashboard. Download access is checked against the current retention setting.

At 0 days, use attachment bytes from the webhook event. There is no later attachment download or replay after content has been purged.

## Usage data

`GET /api/usage` reports the current plan and usage as account data:

- `messages` reports accepted and reserved messages for the current UTC month.
- `domains` and `addressRoutes` report their current use and plan limits.
- `storage` reports retained storage usage, quota, and remaining capacity.
- `retention` reports effective `retentionDays`, the plan maximum `maxDays`, and saved `configuredDays`.
- `period.resetsAt` is the next UTC monthly reset.

Billing changes are available through **Billing** in the account dashboard. Subscription status and plan limits shown in the dashboard are authoritative.

Content access expiry and physical deletion are separate. Wildmail records content-free delivery history after expiry. Expired messages and attachments are removed through the service’s cleanup process, which releases storage capacity. Cleanup may take time, and backup copies have separate expiry policies.
