Restore window

The restore window determines how far back Neon retains a history of changes for your branches. This history retention period powers several Neon features: instant restore (point-in-time recovery), Time Travel queries, branching from past states, and snapshots.

Defaults and plan limits

A longer restore window means:

• You can restore branches to earlier points in time
• Time Travel queries can reach further back
• You can create branches from older historical states
• More WAL records are stored, increasing instant restore storage costs

How it works

Neon stores a continuous record of all changes to your data in the form of Write-Ahead Log (WAL) records. The restore window determines the retention period for this history.

WAL records that exceed your restore window are automatically removed and stop contributing to your project's storage costs.

Storage and billing

The restore window directly affects your instant restore storage costs. Neon retains WAL records for the duration of your restore window. The more history you retain, the more storage you use, and the higher your instant restore storage charges.

This is separate from your regular storage charges for branch data. You're billed for:

• Storage: Your actual data size (root branches) or the minimum of accumulated changes or logical data size (child branches)
• Instant restore storage: The WAL history retained within your restore window

Understand the trade-offs: Reducing your restore window decreases instant restore storage costs but limits how far back you can restore data. Consider your actual recovery requirements and set the window accordingly.

See Cost optimization.

Configure your restore window

Changing the restore window affects all branches in your project.

ConsoleAPI

1. Select your project.

2. Go to Settings > Instant restore.

   

3. Use the slider to select your desired restore window.

4. Click Save.

Production recommendations

For production workloads, consider extending your restore window to 7 days. This provides:

• Protection against data loss from human or application errors that may go unnoticed for several days
• Compliance with retention requirements that may apply to your industry

See Getting ready for production.

Related features

The restore window determines what's available for these features:

• Branching: Create branches from past states
• Time Travel: Query historical data
• Instant restore: Restore a branch to any point within the window
• Snapshots: Capture and restore from specific points