How to export session recordings on PostHog
To export session recordings on PostHog, navigate to the Session Recordings section, filter and select the recordings you want, then use the export functionality to download them as video files or JSON data. You can export individual recordings or bulk export multiple sessions at once.
Prerequisites
- Active PostHog account with session recordings enabled
- Admin or appropriate permissions to access recordings
- Recordings data available in your PostHog instance
- Basic understanding of PostHog dashboard navigation
Step-by-Step Instructions
Access the Session Recordings section
Filter and locate target recordings
- Date range using the date picker
- User properties or cohorts
- Recording duration
- Console errors or network issues
Select recordings for export
Choose export format and options
- Video (MP4) - Complete video file of the session
- JSON Data - Raw session data including events and metadata
- Both - Video and JSON data combined
Configure export settings
- Select video quality (720p, 1080p, or original)
- Choose to include or exclude sensitive data masking
- Set custom filename prefix for organization
- Select compression level for file size optimization
Initiate the export process
- Number of recordings being processed
- Current processing status
- Estimated completion time
Download exported files
- Notifications panel - Click the bell icon and find your export
- Export History - Go to Settings > Export History
- Direct download link in the completion email
Common Issues & Troubleshooting
Export button is grayed out or missing
Ensure you have the necessary permissions to export recordings. Contact your PostHog admin to verify your role includes recording export permissions. Also check that recordings are not empty or corrupted.
Export fails or times out during processing
Try reducing the number of recordings in your export batch. Large exports should be broken into smaller chunks of 50-100 recordings. Check your internet connection and try again during off-peak hours.
Downloaded video files won't play or are corrupted
Verify the export completed successfully in your Export History. Re-download the files and try opening with different video players like VLC. If issues persist, re-export the specific recordings.
JSON export data appears incomplete or missing events
Check if data retention limits affected the recordings. Go to Project Settings > Data retention to verify your retention period. Some older recordings may have partial data due to retention policies.