diff --git a/models/app/features/panels.mdx b/models/app/features/panels.mdx
index 7ce8a0c8e..7cf8ab76e 100644
--- a/models/app/features/panels.mdx
+++ b/models/app/features/panels.mdx
@@ -7,12 +7,36 @@ Use workspace panel visualizations to explore your [logged data](/models/ref/pyt
## Workspace modes
-W&B projects support two different workspace modes. The icon next to the workspace name shows its mode.
+W&B projects support two different workspace modes. The icon next to the workspace name shows its mode.
+
+
+
+ Automatically generate panels for all keys logged in the project.
+
+ Choose an automatic workspace:
+ - To get started quickly by visualizing all available data for the project
+ - For smaller projects that log fewer keys
+ - For more broad analysis
+
+ If you delete a panel from an automatic workspace, you can use [Quick add](#quick-add) to recreate it.
+
+
+ Start as blank slates and display only panels intentionally added by users.
+
+ Choose a manual workspace:
+ - When you care mainly about a fraction of the keys logged in the project
+ - For more focused analysis
+ - To improve workspace performance, avoiding loading panels that are less useful to you
+
+ Use [Quick add](#quick-add) to easily populate a manual workspace and its sections with useful visualizations rapidly.
+
| **Automated workspaces** automatically generate panels for all keys logged in the project. Choose an automatic workspace: