Replay data retention

Last updated:

|Edit this page

Depending on how your app or website is built, recordings can take a lot of disk space. To manage this, we have the following retention policy options in place.

PostHog Cloud

Recordings are automatically deleted after 1 month (3 months for paid customers). The deletion is not immediate meaning that recordings may still appear for a short time in the UI after the retention period expires or when manually deleted via the UI.

Preserving recordings

Pinned or Shared recordings are kept for as long as they are actively in use. Alternatively, any individual recording that you would like to preserve for longer can be done by downloading them locally. Downloaded recordings can then be imported back into PostHog for future playback, even if the original recording has expired.

Self-hosted

In order to make PostHog cheaper and easier to run and maintain. We are deprecating storing recordings in ClickHouse. All releases after 19th September 2023 only officially support blob storage backed recordings.

Self-hosted installations, pinned to earlier versions, are able to control the TTL by updating the RECORDINGS_TTL_WEEKS configuration on your instance settings page.

Please note, for versions of PostHog that rely on Clickhouse storage, you need to manage the available capacity. Ensure you increase volume capacity before changing the RECORDINGS_TTL_WEEKS value (even if you're decreasing the value). ClickHouse requires abundant free disk space to manage the session_recording_events table.

In later versions (which do not use Clickhouse for recording storage), the installation will be relying on its configured blob storage. You can manage storage using blob storage lifecycle policies.

Questions?

Was this page useful?

Next article

Iframe recording

PostHog can record iframes embedded in your website as long as: ✅ The embedded iframe is from the same domain as the main page (e.g. https://posthog.com embeds https://posthog.com/iframe ) ✅ The embedded iframe is from a domain that you can install posthog-js on (e.g. https://posthog.com embeds https://app.posthog.com/iframe ) - requires extra configuration PostHog cannot record iframes embedded in your website if: ❌ The embedded iframe is from a domain than is not under your…

Read next article