Docs
Data Retention
Retention is set per project and enforced automatically — events older than your window are deleted, keeping storage predictable and your compliance story simple.
Retention windows
| Plan | Retention | Notes |
|---|---|---|
| Starter (free) | 30 days | Fixed window, applied per project |
| Growth | Custom | Set the window to match your product and policy needs — talk to us during onboarding |
Your project's current window is shown in the dashboard under Settings → Project → Retention.
How enforcement works
- Retention is evaluated against each event's
occurred_attimestamp. - Events past the window are deleted permanently — they stop appearing in queries, feeds, and exports.
- Actor records (users) are kept as long as they have at least one retained event; their
total_eventsreflects retained history.
Backfilled events
If you backfill history by passing an explicit timestamp when tracking, the retention window applies to that timestamp — backfilling an event older than your window means it will be removed on the next cleanup pass.
Exporting your data
You own your event model. You can page through GET /v1/events with cursor pagination to export your full retained history at any time — for reporting, warehousing, or migration. Growth plans include managed data export.
Need longer retention for compliance (e.g. SOC 2 audit trails)? That's exactly what Growth's custom windows are for — book a call.