From 5d02142004bb0b281fa212e954add57c2b9fb64b Mon Sep 17 00:00:00 2001 From: Tina Ha Date: Tue, 7 Apr 2026 11:09:21 -0400 Subject: [PATCH] docs: clarify pause and restore uses physical backup (#44580) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## I have read the [CONTRIBUTING.md](https://github.com/supabase/supabase/blob/master/CONTRIBUTING.md) file. YES ## What kind of change does this PR introduce? Docs update. This behaviour wasn't previously documented and causes confusion for customers wondering what data state their project will be restored to. ## Additional context Ref slack (Paul at Infra Data): https://supabase.slack.com/archives/C091448H1AM/p1767813291309359?thread_ts=1765466738731989&cid=C091448H1AM ## Summary by CodeRabbit * **Documentation** * Strengthened pause-and-restore guidance to explicitly state downtime occurs during pausing. * Updated pause wording to indicate users are redirected “in the meantime” (removed explicit duration). * Clarified restore is performed from a physical backup and that users will receive an email when complete. * Replaced detailed teardown caveat with a concise note: restoration time depends on database size; contact support if it fails. --- apps/docs/content/guides/platform/upgrading.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/apps/docs/content/guides/platform/upgrading.mdx b/apps/docs/content/guides/platform/upgrading.mdx index bc92ec40c93..d589dd42477 100644 --- a/apps/docs/content/guides/platform/upgrading.mdx +++ b/apps/docs/content/guides/platform/upgrading.mdx @@ -37,12 +37,12 @@ We recommend using the In-place upgrade method, as it is faster, and more reliab -When you pause and restore a project, the restored database includes the latest features. This method _does_ include downtime, so be aware that your project will be inaccessible for a short period of time. +When you pause and restore a project, the restored database includes the latest features. **This method includes downtime**, so be aware that your project will be inaccessible for a short period of time. -1. On the [General Settings](/dashboard/project/_/settings/general) page in the Dashboard, click **Pause project**. You will be redirected to the home screen as your project is pausing. This process can take several minutes. -1. After your project is paused, click **Restore project**. The restoration can take several minutes depending on how much data your database has. You will receive an email once the restoration is complete. +1. On the [General Settings](/dashboard/project/_/settings/general) page in the Dashboard, click **Pause project**. You will be redirected to the home screen in the meantime. +1. After this, click **Restore project**. Your project will be restored from the [physical backup](/guides/platform/backups). You should receive an email once the restoration is complete. -Note that a pause + restore upgrade involves tearing down your project's resources before bringing them back up again. If the restore process should fail, manual intervention from Supabase support will be required to bring your project back online. +Pausing and restoring project will take some time depending on how much data your database has. If the restore process fails, [contact Supabase support](/dashboard/support/new?projectRef=) to bring your project back online. ## Caveats