diff --git a/apps/docs/content/guides/platform/migrating-and-upgrading-projects.mdx b/apps/docs/content/guides/platform/migrating-and-upgrading-projects.mdx
index a0850ee178f..429a1f43dad 100644
--- a/apps/docs/content/guides/platform/migrating-and-upgrading-projects.mdx
+++ b/apps/docs/content/guides/platform/migrating-and-upgrading-projects.mdx
@@ -63,6 +63,39 @@ Breaking changes are generally only present in major version upgrades of Postgre
If you are upgrading from a significantly older version, you will need to consider the release notes for any intermediary releases as well.
+#### Time Limits
+
+Starting from 2024-06-13, when a project is paused, users then have a 90-day window to restore the project on the platform from within Supabase Studio.
+
+The 90-day window allows Supabase to introduce platform changes that may not be backwards compatible with older backups. Unlike active projects, static backups can't be updated to accommodate such changes.
+
+During the 90-day restore window a paused project can be restored to the platform with a single button click from [Studio's dashboard page](https://supabase.com/dashboard/projects).
+
+
+
+
+
+After the 90-day restore window, you can download your project's backup file from the project dashboard. This backup is compatible with [pg_restore](https://www.postgresql.org/docs/current/app-pgrestore.html). You can extract your data from it, or attempt to manually restore the project.
+
+
+
+
+
+If you upgrade to a paid plan while your project is paused, any expired one-click restore options are reenabled. Since the backup was taken outside the backwards compatibility window, it may fail to restore. If you have a problem restoring your backup after upgrading, contact [Support](/support).
+
+
+
+
+
#### Disk sizing
When upgrading, the Supabase platform will "right-size" your disk based on the current size of the database. For example, if your database is 100GB in size, and you have a 200GB disk, the upgrade will reduce the disk size to 120GB (1.2x the size of your database).
diff --git a/apps/docs/public/img/guides/platform/paused-90-day.png b/apps/docs/public/img/guides/platform/paused-90-day.png
new file mode 100644
index 00000000000..531bdc5e458
Binary files /dev/null and b/apps/docs/public/img/guides/platform/paused-90-day.png differ
diff --git a/apps/docs/public/img/guides/platform/paused-dl-backup.png b/apps/docs/public/img/guides/platform/paused-dl-backup.png
new file mode 100644
index 00000000000..9251b3dbbae
Binary files /dev/null and b/apps/docs/public/img/guides/platform/paused-dl-backup.png differ
diff --git a/apps/docs/public/img/guides/platform/paused-paid-tier.png b/apps/docs/public/img/guides/platform/paused-paid-tier.png
new file mode 100644
index 00000000000..245b57b10f9
Binary files /dev/null and b/apps/docs/public/img/guides/platform/paused-paid-tier.png differ
diff --git a/packages/shared-data/config.ts b/packages/shared-data/config.ts
index 1a8a34ce50e..1cdda69a3f0 100644
--- a/packages/shared-data/config.ts
+++ b/packages/shared-data/config.ts
@@ -104,6 +104,15 @@ const config = {
value: 5,
},
},
+ pausing: {
+ /**
+ * Inactivity period after which projects may be paused.
+ */
+ free_tier: {
+ value: '1',
+ unit: 'week'
+ }
+ }
} as const
export default config