diff --git a/docs/operator-manual/ui-customization.md b/docs/operator-manual/ui-customization.md
new file mode 100644
index 0000000000..c6b463e577
--- /dev/null
+++ b/docs/operator-manual/ui-customization.md
@@ -0,0 +1,9 @@
+# UI Customization
+
+## Default Application Details View
+
+By default, the Application Details will show the `Tree` view.
+
+This can be configured on an Application basis, by setting the `pref.argocd.argoproj.io/default-view` annotation, accepting one of: `tree`, `pods`, `network`, `list` as values.
+
+For the Pods view, the default grouping mechanism can be configured using the `pref.argocd.argoproj.io/default-pod-sort` annotation, accepting one of: `node`, `parentResource`, `topLevelResource` as values.
\ No newline at end of file
diff --git a/mkdocs.yml b/mkdocs.yml
index ec626be23b..8305250b8c 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -48,6 +48,7 @@ nav:
   - operator-manual/resource_actions.md
   - operator-manual/custom_tools.md
   - operator-manual/custom-styles.md
+  - operator-manual/ui-customization.md
   - operator-manual/metrics.md
   - operator-manual/web_based_terminal.md
   - operator-manual/config-management-plugins.md