diff --git a/references/lightdash-cli.mdx b/references/lightdash-cli.mdx
index ee39e72d..7bd1ee53 100644
--- a/references/lightdash-cli.mdx
+++ b/references/lightdash-cli.mdx
@@ -610,6 +610,9 @@ You can make changes to the code and upload these changes back to your Lightdash
 - `--language-map` or `-l`
   - (default: false)
   - generate `<item name>.language.map.yml` for the downloaded charts and dashboards with all translatable text from charts and dashboards
+- `--nested`
+  - (default: false)
+  - split downloaded content into sub-folders matching the spaces in your project
 
 **Examples:**
 
@@ -639,6 +642,12 @@ You can also use relative paths like:
 lightdash download -p ../
 ```
 
+Download all charts and dashboards organized by space.
+
+```bash
+lightdash download --nested
+```
+
 Download all charts and dashboards from a specific project with language maps.
 
 ```bash
@@ -676,6 +685,9 @@ If there have been changes made to a chart or dashboard in the application that
 - `--validate`
   - (default: false)
   - Validate charts and dashboards after upload and display any validation errors
+- `--nested`
+  - (default: false)
+  - expect content to be organized in sub-folders matching the spaces in your project (use this if content was downloaded with `--nested`)
 
 **Examples:**