Skip to main content

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​

FreeStarterGrowth
Monthly price€0€20€49
Custom domains1310
Accepted messages per UTC month10,00030,000100,000
Maximum complete raw email5 MiB25 MiB25 MiB
Retained storage capacity5 GB50 GB150 GB
Maximum content retention7 days30 days60 days
Exact-address routesNot includedUnlimitedUnlimited

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.