diff --git a/apps/docs/pages/guides/platform/database-usage.mdx b/apps/docs/pages/guides/platform/database-usage.mdx
index 6ce6385770d..c3db3e86d78 100644
--- a/apps/docs/pages/guides/platform/database-usage.mdx
+++ b/apps/docs/pages/guides/platform/database-usage.mdx
@@ -27,16 +27,33 @@ For Pro and Enterprise projects, disk size expands ~1.5x automatically (e.g., 8G
 Disk size expansion can only occur once every six hours.
 Pro projects can store up to 1024TB.
 
-All projects enter read-only mode when you reach 95% of the disk size. In read-only mode, clients will encounter errors such as `cannot execute INSERT in a read-only transaction`.
+### Free tier project 'read-only' mode at 95% disk size use
+
+Free tier projects enter read-only mode when you reach 95% of the disk size.
+In read-only mode, clients will encounter errors such as `cannot execute INSERT in a read-only transaction`.
 Regular operation (read-write mode) is automatically re-enabled once usage is below 95% of the disk size.
 
+For automatic disk resizing, and avoid your database entering read-only mode, you can [upgrade to the Pro or Enterprise plan](https://app.supabase.com/project/_/settings/billing/subscription).
+
+### Paid tier automatic disk resizing
+
+If you are on Pro or Enterprise, database storage expands automatically. Usually the disk is expanded to be 50% larger.
+
+However, you may also encounter this error if you fill the database faster than it can expand. For every automatic database storage expansion, it will not auto expand for another 6 hours.
+
+During this 6 hour period, if you reach 95% of the disk space, your project may enter read-only mode. In read-only mode, clients will encounter errors such as `cannot execute INSERT in a read-only transaction`.
+Regular operation (read-write mode) is automatically re-enabled once usage is below 95% of the disk size.
+
+If you intend to import a lot of data into your database that would require multiple storage expansions then [reach out to our team](https://app.supabase.com/support/new).
+
 If you need more than 1024TB of disk size or require multiple storage expansions in a short period of time, [contact us](https://app.supabase.com/support/new) to learn more about the Enterprise plan.
 
 ### Increasing available disk size
 
 1. [Upgrade to the Pro or Enterprise plan](https://app.supabase.com/project/_/settings/billing/subscription) to increase your quota and expand your disk size automatically.
 
-2. Delete data from your project's database to lower its disk usage. If your database is already in read-only mode, run the following command to change the transaction mode to read-write for your session:
+2. Delete data from your project's database to lower its disk usage.
+   If your database is already in read-only mode, run the following command to change the transaction mode to read-write for your session:
 
    ```sql
    SET