diff --git a/modules/administration-guide/pages/configuring-single-and-multiroot-workspaces.adoc b/modules/administration-guide/pages/configuring-single-and-multiroot-workspaces.adoc
index cd4004999c..06295ef4c6 100644
--- a/modules/administration-guide/pages/configuring-single-and-multiroot-workspaces.adoc
+++ b/modules/administration-guide/pages/configuring-single-and-multiroot-workspaces.adoc
@@ -89,3 +89,23 @@ If the workspace file does not exist in the first project, a new one will be cre
      - name: VSCODE_DEFAULT_WORKSPACE
        value: "/"
 ----
+
+* Open the projects root folder in empty workspaces.
+
+** By default, when a workspace has no projects defined in its devfile (for example, the dashboard's built-in "Empty Workspace"), the editor opens with an empty Explorer. To automatically open the `/projects` folder instead, define the __OPEN_PROJECTS_ROOT_ON_EMPTY__ environment variable in your devfile.
++
+pass:[<!-- vale RedHat.TermsErrors = NO -->]
++
+[source,yaml]
+----
+   env:
+     - name: OPEN_PROJECTS_ROOT_ON_EMPTY
+       value: "true"
+----
++
+pass:[<!-- vale RedHat.TermsErrors = YES -->]
++
+[NOTE]
+====
+This setting only applies when the workspace has no projects, dependent projects, or starter projects defined. Workspaces that already have folders configured are not affected.
+====