Branch archiving

To minimize storage costs, Neon automatically archives branches that are:

• Older than 14 days.
• Have not been accessed for the past 24 hours

Both conditions must be true for a branch to be archived. Additionally, these conditions apply:

• A branch cannot be archived if it has an unarchived child branch.
• A child branch must be archived before a parent branch can be archived.

Unarchiving a branch

No action is required to unarchive a branch. It happens automatically.

Connecting to an archived branch, querying it, or performing some other action that accesses it will trigger the unarchive process. Connection times and query times may be slower while a branch is in the process of being unarchived.

The following actions will automatically unarchive a branch, transferring the branch's data back to regular Neon storage:

• Connecting to or querying the branch from a client or application
• Querying the branch from the Neon SQL Editor
• Viewing the branch on the Tables page in the Neon Console
• Creating a child branch
• Creating a role on a branch
• Creating a database on a branch
• Reset the branch from its parent
• Performing a restore operation on a branch
• Setting the branch as protected
• Running Neon CLI commands or Neon API calls that access the branch

Identifying archived branches

Archived branches can be easily identified in the Neon Console. On the Branches page, archived branches are identified by an archive icon, as shown below:

If you select an archived branch on the Branches page to view its details, you can find out when the branch was archived:

Archive and unarchive operations can also be monitored in the Neon Console or using the Neon API. See Monitoring branch archiving.

About archive storage

For Neon projects created in AWS regions, inactive branches are archived in Amazon S3 storage. For Neon projects created in Azure regions, branches are archived in Azure Blob storage. For more information about how archive storage works in Neon, refer to Archive storage in our architecture documentation.

Is automatic branch archiving configurable?

Branch archiving is not configurable. Archiving and unarchiving happen automatically, as described above.

Monitoring branch archiving

You can monitor branch archive and unarchive operations from the System operations tab on the Monitoring page in the Neon Console. Look for the following operations:

• Timeline archive: The time when the branch archive operation was initiated
• Timeline unarchive: The time when the branch unarchive operation was initiated

For related information, see System operations.

You can also monitor branch states using the Neon CLI or Neon API.

CLIAPI

The Neon CLI branches list command shows a branch's Current State. Branch states include:

• init - the branch is being created but is not available for querying.

• ready - the branch is fully operational and ready for querying. Expect normal query response times.

• archived - the branch is stored in cost-effective archive storage. Expect slow query response times.

  neon branches list --project-id green-hat-46829796
  ┌───────────────────────────┬──────┬─────────┬───────────────┬──────────────────────┐
  │ Id                        │ Name │ Default │ Current State │ Created At           │
  ├───────────────────────────┼──────┼─────────┼───────────────┼──────────────────────┤
  │ br-muddy-firefly-a7kzf0d4 │ main │ true    │ ready         │ 2024-10-30T14:59:57Z │
  └───────────────────────────┴──────┴─────────┴───────────────┴──────────────────────┘