diff --git a/charts/workspace/scripts/env.reference.yaml b/charts/workspace/scripts/env.reference.yaml
index 3d8668c..a3ecf10 100644
--- a/charts/workspace/scripts/env.reference.yaml
+++ b/charts/workspace/scripts/env.reference.yaml
@@ -23,6 +23,7 @@ envs:
       additional_gpg_keys:
         type: string
         default: null
+        delimiter: " "
         reference: /tools/apt
         example: >-
           name1:keys.example.com/key1.asc name2:keys.example.com/key2.gpg
@@ -37,6 +38,7 @@ envs:
       additional_insecure_gpg_keys:
         type: string
         default: null
+        delimiter: " "
         since: 0.1.0
         reference: /tools/apt
         example: >-
@@ -57,6 +59,7 @@ envs:
       additional_packages:
         type: string
         default: null
+        delimiter: " "
         reference: /tools/apt
         example: cmake nano
         description: Additional APT packages installed during startup.
@@ -66,6 +69,7 @@ envs:
       additional_repos:
         type: string
         default: null
+        delimiter: ;
         reference: /tools/apt
         example: >-
           deb http://one.test trixie main; deb http://two.test trixie main
@@ -79,6 +83,7 @@ envs:
       disable_repos:
         type: string
         default: null
+        delimiter: " "
         reference: /tools/apt
         example: debian additional
         description: Disables specified APT repositories or all repositories.
@@ -93,6 +98,7 @@ envs:
       disable_restrictions:
         type: string
         default: null
+        delimiter: " "
         since: 0.2.2
         reference: /tools/apt
         example: x11 mail
@@ -207,6 +213,7 @@ envs:
       additional_cert_endpoints:
         type: string
         default: null
+        delimiter: " "
         since: 0.0.20
         reference: /settings/enterprise-ca
         example: https://corp.com/ca.pem https://alt.com/root.crt
@@ -219,6 +226,7 @@ envs:
       additional_cert_insecure_endpoints:
         type: string
         default: null
+        delimiter: " "
         since: 0.0.22
         reference: /settings/enterprise-ca
         example: http://corp.com/ca.pem https://untrusted.com/root.crt
@@ -296,6 +304,7 @@ envs:
       additional_vs_extensions:
         type: string
         default: null
+        delimiter: " "
         since: 0.0.20
         example: dbaeumer.vscode-eslint esbenp.prettier-vscode
         description: Installs these Marketplace extension IDs at startup.
@@ -378,6 +387,7 @@ envs:
       trusted_domains:
         type: string
         default: null
+        delimiter: ","
         since: 0.2.0
         example: >-
           https://github.com,https://stackoverflow.com
@@ -400,6 +410,7 @@ envs:
         reference: /editor/features
         type: string
         default: null
+        delimiter: " "
         since: 0.0.20
         example: dotnet jupyter
         description: Installs additional feature at startup.
@@ -500,6 +511,7 @@ envs:
       collectors:
         type: string
         default: "*"
+        delimiter: ","
         since: 0.1.2
         example: workspace,container.cpu,gpu
         description: Comma-separated list of metric collectors to enable.
@@ -616,6 +628,7 @@ envs:
       proxy_domain:
         type: string
         default: null
+        delimiter: " "
         since: 0.0.20
         example: ws.dev local.ws.dev
         description: >-
@@ -728,9 +741,13 @@ envs:
       additional_plugins:
         type: string
         default: null
+        delimiter: " "
         since: 0.0.20
         example: php
         description: Loads additional `oh-my-zsh` plugins.
+        longDescription: |
+          Accepts a **space-delimited** list of plugin names appended to the
+          built-in `oh-my-zsh` plugin set.
 
       fzf_history_args:
         type: string
@@ -794,8 +811,13 @@ envs:
           1password auto-venv docker encode64 fzf-history git
           golang helm kubectl npm python pip
           ssh-agent yarn zsh-autosuggestions
+        delimiter: " "
         example: kubectl npm python pip
         description: Enables built-in `oh-my-zsh` plugins.
+        longDescription: |
+          Accepts a **space-delimited** list of plugin names. Replaces the
+          default plugin set; use `WS_ZSH_ADDITIONAL_PLUGINS` to extend it
+          instead.
 
 
 deprecated: