diff --git a/src/pages/guides/app_builder_guides/storage/database.md b/src/pages/guides/app_builder_guides/storage/database.md
index 747c53dba..63f0ed3bb 100644
--- a/src/pages/guides/app_builder_guides/storage/database.md
+++ b/src/pages/guides/app_builder_guides/storage/database.md
@@ -45,7 +45,7 @@ application:
       region: emea
 ```
 
-When the application is deployed using `aio app deploy` a database will be provisioned in the specified region unless it is already present.
+When the application is deployed using `aio app deploy` a database will be provisioned in the specified region unless it is already present. Declarative provisioning does not occur during `aio app run` or `aio app dev` commands, so the database will need to be provisioned manually using the AIO CLI for local development.
 
 To provision a database using the AIO CLI, the following command can be used:
 
diff --git a/src/pages/guides/app_builder_guides/storage/db-troubleshooting.md b/src/pages/guides/app_builder_guides/storage/db-troubleshooting.md
index ddafabd3c..1a8cecffc 100644
--- a/src/pages/guides/app_builder_guides/storage/db-troubleshooting.md
+++ b/src/pages/guides/app_builder_guides/storage/db-troubleshooting.md
@@ -235,6 +235,7 @@ Likely causes include:
 
 - A known issue in auto-provisioning logic in older `@adobe/aio-cli-plugin-app` / `@adobe/aio-cli-plugin-app-storage` versions.
 - Region misconfiguration in app.config.yaml.
+- Running the app locally through `aio app run` or `aio app dev` without manually provisioning a database first.
 
 To fix this error: