diff --git a/docs/catalogs.md b/docs/catalogs.md
index 5d7c7cba4d4a..94e41a58d0b6 100644
--- a/docs/catalogs.md
+++ b/docs/catalogs.md
@@ -165,3 +165,7 @@ The `catalog:` protocol replacement process allows the `@example/components` pac
 import CatalogMode from './settings/_catalogMode.mdx'
 
 <CatalogMode />
+
+import CleanupUnusedCatalogs from './settings/_cleanupUnusedCatalogs.mdx'
+
+<CleanupUnusedCatalogs />
diff --git a/docs/settings.md b/docs/settings.md
index 0e5da2a45e41..a1d7950f1dcc 100644
--- a/docs/settings.md
+++ b/docs/settings.md
@@ -1774,3 +1774,7 @@ Added in: v10.12.1
 * Type: **Boolean**
 
 This setting explicitly tells pnpm whether the current environment is a CI (Continuous Integration) environment.
+
+import CleanupUnusedCatalogs from './settings/_cleanupUnusedCatalogs.mdx'
+
+<CleanupUnusedCatalogs />
diff --git a/docs/settings/_cleanupUnusedCatalogs.mdx b/docs/settings/_cleanupUnusedCatalogs.mdx
new file mode 100644
index 000000000000..efbc7a1431fa
--- /dev/null
+++ b/docs/settings/_cleanupUnusedCatalogs.mdx
@@ -0,0 +1,9 @@
+### cleanupUnusedCatalogs
+
+Added in: v10.15.0
+
+* Default: **false**
+* Type: **Boolean**
+
+When set to `true`, pnpm will remove unused catalog entries during installation.
+