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.

However, a branch cannot be archived if it:

• Has an unarchived child branch.
• Has computes running.
• Is in transition (e.g., currently being created or unarchived).
• Is a protected branch (learn more).

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. Branches with large amounts of data may experience slightly slower connection and query times while a branch is being unarchived.

For projects on paid Neon plans, there is a limit of 100 unarchived branches per project. If a project reaches this limit, Neon archives branches without waiting for the 14-day or 24-hour archiving criteria described above.

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 identified by an archive icon on the Branches page in the Neon Console:

If you select an archived branch on the Branches page to view its details, you can see 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 branch archiving configurable?

Branch archiving thresholds are not configurable. Archiving and unarchiving happen automatically according to the thresholds and conditions described above.

Disabling branch archiving

You cannot fully disable branch archiving, but you can prevent a branch from being archived by defining it as a protected branch. For instructions, see Set a branch as protected. Protected branches are supported on Neon paid plans.

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 archiving 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 │
  └───────────────────────────┴──────┴─────────┴───────────────┴──────────────────────┘