From c5de8f7ed946ed2cd09e12b306214147e21a6a1c Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Fri, 5 Jun 2026 02:19:03 +0000
Subject: [PATCH] docs: document datastore storage resource controls

---
 addons/datastores.mdx | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/addons/datastores.mdx b/addons/datastores.mdx
index 31ece02..bd8c92f 100644
--- a/addons/datastores.mdx
+++ b/addons/datastores.mdx
@@ -129,6 +129,33 @@ Provisions an Amazon Elasticache replication group with:
 
 ---
 
+## Managing resources
+
+After a datastore is created, you can adjust its compute and storage allocation from the **Resources** tab when viewing the datastore in the Porter dashboard.
+
+### Compute
+
+Change the instance type to scale CPU and memory up or down. The selector lists every instance class compatible with your datastore engine (RDS, Aurora, or Elasticache).
+
+### Storage
+
+For RDS datastores, the **Resources** tab includes a **Storage** section where you can increase the allocated disk size.
+
+- **Disk size**: Enter the new size in GB. The input enforces a minimum equal to the currently allocated size and a maximum of 20,480 GB.
+- **Utilization bar**: Displays current usage, available capacity, and any newly available capacity from a pending increase, so you can see the impact of your change before applying it.
+
+<Warning>
+Storage increases are supported, but decreases are not. Plan your increases carefully — once applied, the new size becomes the new minimum.
+</Warning>
+
+<Info>
+Storage controls are only available for standard RDS datastores. Aurora manages storage automatically, in-cluster datastores have fixed storage, and Elasticache does not use disk storage.
+</Info>
+
+Click **Update** to apply pending compute and storage changes together. The datastore performs a modification in place, which may briefly affect availability depending on the engine and configuration.
+
+---
+
 ## Monitoring
 
 You can monitor the performance of your database from the Porter dashboard. Metrics are available in the "Metrics" tab when opening a datastore.