From 9f5e5c576fff3422c3d99021479d0fc2c36b787a Mon Sep 17 00:00:00 2001
From: Paul Bottein <paul.bottein@gmail.com>
Date: Thu, 29 Sep 2022 21:34:09 +0200
Subject: [PATCH] Add subview documentation (#24277)

---
 source/dashboards/views.markdown | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/source/dashboards/views.markdown b/source/dashboards/views.markdown
index 77b645a5a58..9a6294216a6 100644
--- a/source/dashboards/views.markdown
+++ b/source/dashboards/views.markdown
@@ -125,6 +125,28 @@ frontend:
       lovelace-background: center / cover no-repeat url("/local/background.png") fixed
 ```
 
+## Subview
+
+View can be marked as "Subview". Subviews won’t show up in the navigation bar. When on the subview, the navigation bar only show the name of the subview and a back button.
+By default, clicking on back button will navigate to the previous view but a custom back path (`back_path`) can be set.
+
+#### Example
+
+Simple subview:
+
+```yaml
+- title: Map
+  subview: true
+```
+
+Subview with custom back path:
+
+```yaml
+- title: Map
+  subview: true
+  back_path: /lovelace/home
+```
+
 {% configuration views %}
 views:
   required: true
@@ -170,6 +192,15 @@ views:
       description: "Hide/show the view tab from all users or a list of individual `visible` objects."
       type: [boolean, list]
       default: true
+    subview:
+      required: false
+      description: Mark the view as "Subview", more info below.
+      type: boolean
+      default: false
+    back_path:
+      required: false
+      description: Only for subview. Path to navigate when clicking on back button, more info below.
+      type: string
 {% endconfiguration %}
 
 #### Example