How to Delete a Neon Project (and Recover It)

How to fix it

Try these in order — the most common fix is first.

1. 1. Delete the project

   Copy steps
   1. Open console.neon.tech and select the project
   2. Go to Settings, General tab
   3. Under Delete project, click Delete project (requires Admin access)
   4. Deleting removes computes, branches, databases and roles; custom domains are not released, delete them first
   Did this fix it? Yes No

2. 2. Recover within 7 days

   Copy steps
   1. Console, Projects page, click Manage on the banner about projects to be permanently deleted
   2. Find it in Recently deleted projects and click Recover
   3. Re-enable Data API, GitHub integration and similar settings afterward
   Did this fix it? Yes No

3. 3. Back up first

   1. Export with pg_dump using the direct (non-pooler) connection string before deleting
   Did this fix it? Yes No

Symptoms

You want to remove a Neon project or database, or free your project count.

Why it happens

• Cleaning up old or test projects
• Moving to another provider

This guide also covers

• delete neon project
• how to delete neon database
• neon recover deleted project

Other Neon errors

• Neon Connection Timeout After Scale to Zero (Cold Start)
• Neon "Remaining Connection Slots Are Reserved" (Too Many Connections)
• Neon Compute Time Quota Exceeded (Free Plan Limit Reached)
• Neon Free Plan Storage Limit Reached (Writes Blocked)
• Neon Cannot Create Branch: Branch Limit Reached
• Neon Prisma or Drizzle Migration Fails (Pooled Connection)
• Neon SSL Required Error (Connection Is Insecure)
• Neon "The Endpoint ID Is Not Specified" / Password Authentication Failed