diff --git a/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md b/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md
index 2dcc17e4ee9..ec33e40b5b1 100644
--- a/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md
+++ b/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md
@@ -28,7 +28,12 @@ dbt Labs is committed to providing backward compatibility for all versions 1.x,
 
 ## New and changed features and functionality
 
-Coming soon!
+Features and functionality new in dbt v1.8
+
+### The `--empty` flag
+
+The [`run`](/reference/commands/run#the-`--empty`-flag) and [`build`](/reference/commands/build#the---empty-flag) commands now support the `--empty` flag for building schema-only dry runs. The `--empty` flag limits the refs and sources to zero rows. dbt will still execute the model SQL against the target data warehouse but will avoid expensive reads of input data. This validates dependencies and ensures your models will build properly.
+
 
 ## Quick hits
 
diff --git a/website/docs/reference/commands/build.md b/website/docs/reference/commands/build.md
index 846810c1652..c83f669fe26 100644
--- a/website/docs/reference/commands/build.md
+++ b/website/docs/reference/commands/build.md
@@ -25,6 +25,14 @@ In DAG order, for selected resources or an entire project.
 
 **Flags:** The `build` task supports all the same flags as `run`, `test`, `snapshot`, and `seed`. For flags that are shared between multiple tasks (e.g. `--full-refresh`), `build` will use the same value for all selected resource types (e.g. both models and seeds will be full refreshed).
 
+<VersionBlock firstVersion="1.8">
+
+### The `--empty` flag
+
+The `build` command supports the `--empty` flag for building schema-only dry runs. The `--empty` flag limits the refs and sources to zero rows. dbt will still execute the model SQL against the target data warehouse but will avoid expensive reads of input data. This validates dependencies and ensures your models will build properly.
+
+</VersionBlock>
+
 ### Examples
 
 ```
diff --git a/website/docs/reference/commands/run.md b/website/docs/reference/commands/run.md
index 557d0d71338..609503e62dd 100644
--- a/website/docs/reference/commands/run.md
+++ b/website/docs/reference/commands/run.md
@@ -80,3 +80,11 @@ See [global configs](/reference/global-configs/failing-fast)
 ## Enable or Disable Colorized Logs
 
 See [global configs](/reference/global-configs/print-output#print-color)
+
+<VersionBlock firstVersion="1.8">
+
+## The `--empty` flag
+
+The `run` command supports the `--empty` flag for building schema-only dry runs. The `--empty` flag limits the refs and sources to zero rows. dbt will still execute the model SQL against the target data warehouse but will avoid expensive reads of input data. This validates dependencies and ensures your models will build properly.
+
+</VersionBlock>
\ No newline at end of file