From 2e144a2dbecd338f268b2531a14b5959fa67df1e Mon Sep 17 00:00:00 2001
From: Dan Harrin <git@danharrin.com>
Date: Tue, 12 Aug 2025 10:14:50 +0100
Subject: [PATCH] Update 14-upgrade-guide.md

---
 docs/14-upgrade-guide.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/14-upgrade-guide.md b/docs/14-upgrade-guide.md
index 4b56088fdc..1caa50565b 100644
--- a/docs/14-upgrade-guide.md
+++ b/docs/14-upgrade-guide.md
@@ -61,6 +61,12 @@ Make sure to carefully follow the instructions, and review the changes made by t
 
 Filament v4 introduces a new default directory structure for your Filament resources and clusters. If you are using Filament panels with resources and clusters, you can choose to keep the old directory structure, or migrate to the new one. If you want to migrate to the new directory structure, you can run the following command:
 
+```bash
+php artisan filament:upgrade-directory-structure-to-v4 --dry-run
+```
+
+The `--dry-run` option will show you what the command would do without actually making any changes. If you are happy with the changes, you can run the command without the `--dry-run` option to apply the changes:
+
 ```bash
 php artisan filament:upgrade-directory-structure-to-v4
 ```
@@ -120,6 +126,12 @@ return [
 <Aside variant="tip">
     The `filament/upgrade` package includes a command to help you move panel resources and clusters to the new directory structure, which is the default in v4:
 
+    ```bash
+    php artisan filament:upgrade-directory-structure-to-v4 --dry-run
+    ```
+
+    The `--dry-run` option will show you what the command would do without actually making any changes. If you are happy with the changes, you can run the command without the `--dry-run` option to apply the changes:
+
     ```bash
     php artisan filament:upgrade-directory-structure-to-v4
     ```