Use Neon as your dev environment for AWS RDS: accelerate your workflow while reducing costs

Branch reset and restore

Learn about the different branch reset and restore features in Neon

Neon retains a history of changes for all branches. This shared history provides the basis for a variety of branch restore and reset operations: resetting a branch to its parent, restoring a branch to its history, creating a new branch from a selected point-in-time, and Time Travel queries against the shared history. You can use these features to reset a development branch to main, to recover lost data, as a database backup strategy, or to view the past state of your database.

History retention

The history retention limit is 24 hours for Neon Free Tier users, 7 days for Launch plan users, and 30 days for Scale plan users.

You can configure the History retention setting in the Neon Console, under Project settings > Storage. For further instructions, see Configure history retention. History retention configuration

Increasing the history retention period affects all branches in your Neon project and increases project storage. You can scale History retention down to zero if reducing storage cost is more important than the ability to restore your data to a past state.

History is retained in the form of Write-Ahead-Log (WAL) records. As WAL records age out of the retention period, they are evicted from storage and no longer count toward project storage.

Branch reset and restore features

Find out more about the different branch reset and restore features that Neon provides.

Last updated on

Edit this page
Was this page helpful?