Deleting Your Project

Understanding the permanent consequences and how to protect yourself

Deleting a Supabase project is a permanent and irreversible action. Before proceeding, understand the full scope of what will be deleted and take precautions to prevent accidental data loss.

We cannot recover deleted projects. All data, backups, and configurations are permanently removed. Ensure you have exported all critical data or saved backups before proceeding to delete your project.

What gets deleted#

When you delete a project, all artifacts are permanently removed and you cannot recover them. Some of these artifacts includes (but are not limited to):

Database and all data: Your entire Postgres database, including all tables, schemas, and records
Edge Functions: All deployed Edge Functions and their source code are removed
Storage objects: All files in Storage buckets are permanently deleted
Backups: All automated backups and point-in-time recovery snapshots are inaccessible
Authentication data: User accounts, sessions, and auth logs are removed
Real-time subscriptions: All active subscriptions and configurations are cleared
API keys and credentials: All project API keys, service role keys, and webhooks are invalidated
Custom domains and SSL certificates: Any custom domains linked to the project are removed

How to delete a project#

You can delete a project through any of these methods:

Via dashboard#

Navigate to your project's Settings > General > Delete project
Click Delete Project
Enter your project name exactly as it appears to confirm
Review the confirmation dialog and click Delete

Via Supabase CLI#

1
supabase projects delete <project-ref>

For more information, see the Supabase CLI documentation.

Via management API#

1
curl -X DELETE https://api.supabase.com/v1/projects/<project-ref> \
2
  -H "Authorization: Bearer <access-token>"

For more information, see the Management API documentation.

After deletion#

Once a project is deleted:

Your project URL will no longer be accessible
DNS records will be cleaned up (may take up to 24 hours to fully propagate)
Billing for this project will stop immediately
You cannot recover or restore the project

Deleting projects stops new usage from accumulating, but does not remove usage that already occurred during the current billing cycle. For quota-based limits, that usage still counts until the billing period resets. See our Fair Use Policy for further details.

Alternative: Pause your project#

If you're unsure about deletion, consider pausing your project instead:

Note: Only Free Projects can be paused at this time.

Paused projects stop incurring compute charges
Data is preserved and can be accessed when you resume
Quick recovery — Resume the project at any time without data loss

To pause a project, navigate to Settings > General > Project availability and click Pause Project.

Protective measures to consider#

To safeguard against accidental deletion, consider the following:

1. Backup your database#

You can backup your database by following the backup and restore guide provided.

If you are on the Pro, Team or Enterprise Plan, with legacy logical backups, you can download a copy from your Supabase dashboard

2. Download storage objects#

Back up all important files from Storage buckets
Use the Supabase dashboard or API to download files in bulk
Store in a secure location outside of Supabase

3. Document configuration#

Export Edge Function code and configurations from the dashboard
Save authentication provider settings (OAuth, SAML, etc.)
Document any custom database functions, triggers, or policies
Record webhook configurations and integrations

4. Enable access controls#

Restrict who can delete projects within your organization to prevent accidental deletion by team members. See Access Controls

Set up role-based access controls to limit deletion permissions
Require multi-factor authentication (MFA) for sensitive operations
Use the Supabase dashboard to configure team member permissions

5. Monitor project activity#

Enable audit logging to track who has access to your project
Review and revoke unnecessary API keys before deletion
Check for any scheduled jobs or integrations that depend on the project

Need help?#

If you're unsure about deletion or need assistance:

Review this guide and the protection measures above
Contact Supabase support for guidance
Consider reaching out to your team before deleting shared projects