From a8173a5826c9d09223f4553b546ec5aec83df609 Mon Sep 17 00:00:00 2001
From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Date: Thu, 20 Jul 2023 15:01:13 +0200
Subject: [PATCH] Assist: procedure on adding the Assist dashboard button
 (#28254)

* Assist: procedure on adding the Assist dashboard button

* Move task to its own page

* Add explanation why button is even needed

* Rephrase title
---
 source/_includes/asides/voice_navigation.html  |  1 +
 .../start_assist_from_dashboard.markdown       | 18 ++++++++++++++++++
 2 files changed, 19 insertions(+)
 create mode 100644 source/voice_control/start_assist_from_dashboard.markdown

diff --git a/source/_includes/asides/voice_navigation.html b/source/_includes/asides/voice_navigation.html
index b08c7938cb7..9b895f03a1a 100644
--- a/source/_includes/asides/voice_navigation.html
+++ b/source/_includes/asides/voice_navigation.html
@@ -18,6 +18,7 @@
       <li>{% active_link /voice_control/builtin_sentences/ Built-in sentences %}</li>
       <li>{% active_link /voice_control/custom_sentences/ Custom sentences %}</li>
       <li>{% active_link /voice_control/using_tts_in_automation/ Using Piper TTS in automations %}</li>
+      <li>{% active_link /voice_control/start_assist_from_dashboard/ Starting Assist from your dashboard %}</li>
       <li>{% active_link /voice_control/troubleshooting/ Troubleshooting Assist %}</li>
     </ul>
   </div>
diff --git a/source/voice_control/start_assist_from_dashboard.markdown b/source/voice_control/start_assist_from_dashboard.markdown
new file mode 100644
index 00000000000..b7cb836d765
--- /dev/null
+++ b/source/voice_control/start_assist_from_dashboard.markdown
@@ -0,0 +1,18 @@
+---
+title: "Starting Assist from your dashboard"
+---
+
+If you are using Home Assistant in kiosk mode, for example if you have a tablet mounted on the wall, the Assist icon in the top right corner is not accessible. In this case, use a dashboard button to start Assist.
+
+## To add an Assist button to the dashboard
+
+1. On your dashboard, select **Add card** and select the **Button** card.
+2. Clear the **Entity** field and give the card a name, such as *Assist - listen*.
+3. Select an icon, such as `mdi:account-tie-voice`.
+4. From the **Action** dropdown menu, select **Assist**.
+5. From the **Assist** dropdown menu, select the assistant you want to use, for example **Home Assistant Cloud**.
+   - You can use any assistant you have previously set up.
+   - If you have assistants in different languages, you can add a button for each of these languages.
+6. If you are using Assist with your voice, enable **Start listening**.
+   - If you don't want to use voice but just want to type, you do not need to enable listening. 
+7. **Save** your new button card.