Time to Live (TTL)

Amplitude Data's Time-to-Live (TTL) feature lets you have control over how long event data lives in your Amplitude instance. Set the retention period for event data at the organization level, and override it at the project level. When you enable TTL, a job runs daily to make sure that Amplitude retains your event data according to your TTL policy.

Considerations

• Amplitude uses the date the event data reaches the Amplitude server when determining the retention period. Therefore, any backfill or migration of event data may affect the retention period for that event data.
• When you enable TTL and set a retention period, Amplitude deletes all event data sent to Amplitude outside of your retention period.
• Configure the retention period by number of months. Amplitude's default month is 30 days. For example, if you set your retention period to 4 months, Amplitude retains all event data for the last 120 days.
• Enabling TTL affects existing Amplitude reports. After you enable TTL, Amplitude zeros out charts that query data outside the set retention period. They appear as if the data for that period never existed within Amplitude.
• The initial deletion may take longer than daily deletions. Depending on an organization’s historical event volume, it may take up to 30 days.

Enable TTL

To have TTL controls enabled for your organization, reach out to your Account Manager at Amplitude or fill out a support request.

Configure TTL for your organization

Amplitude Admins can configure TTL.

1. Navigate to Organization Settings and click the Time to Live(TTL) tab.
2. Choose the retention period.
3. Confirm your changes.

After you confirm, deletion of your event data starts in 24 hours. It may take up to 30 days for the initial deletion.

Add a project-level TTL override

Amplitude Admins can add overrides.

1. Navigate to Organization Settings and click the Time to Live(TTL) tab.
2. Click Add Project TTL Override.
3. Search for and select the project, and set the retention period.
4. Click Save to update the project's retention.