home-assistant.io/source/voice_control/builtin_sentences.markdown

title, related

title

related

Assist - default sentences

docs title /voice_control/aliases/ Create aliases docs title /voice_control/custom_sentences/ Create your own sentences docs title /voice_control/troubleshooting/ Sentence troubleshooting url title https://github.com/home-assistant/intents/tree/main/sentences Built-in sentence definitions url title https://github.com/home-assistant/intents/tree/main/responses Built-in response definitions url title https://developers.home-assistant.io/docs/voice/intent-recognition/template-sentence-syntax/ Template sentence syntax documentation url title https://github.com/home-assistant/intents/tree/main/sentences Sentence test cases

Home Assistant comes with built-in sentences contributed by the community for dozens of languages.

These sentences allow you, for example, to:

• Turn entities on and off

  • "turn on the living room light"
  • "turn off ceiling fan"
  • "turn on the TV"
  • "lock all the doors"
  • "open the main door"

• Open, close covers, or ask about their state

  • "Close the garage door"
  • "Open kitchen window"
  • "Which curtains are closed"
  • "Set bedroom curtain to 50%"

• Set the brightness and color of lights

  • "Change kitchen lights brightness to 50%"
  • "Set bed light to green"

• Ask about the weather

  • "What is the weather"
  • Struggling with this one? Check the troubleshooting section.

• Add items to a list

  • "Add bread to my shopping list"
  • "Add decorating christmas tree to my december chores list"

• Get information about a state

  • "What is the amount of energy from solar production?"
  • "what is the heat pump co2 sensor's co2 level?"
  • "what is the battery level of my phone?"

• Run a script

  • "Run stealth mode script"

• Activate a scene

  • "Activate dinner scence"
  • "Turn kitchen dinner scene on"

• Inquire about people (that have device tracking activated in Home Assistant)

  • "How many people are in the kitchen"
  • "Who is in the garage"
  • "Where is Anne"

• Control the media player

  • "next item on TV"
  • "skip song on the TV"
  • "skip track on the TV"
  • "skip to the next song on the TV"
  • "pause TV"
  • "TV pause"
  • "unpause TV"
  • "TV unpause"
  • "resume TV"
  • "set TV volume to 90 percent"
  • "change the TV volume to 90"
  • "turn TV volume down to 90 percent"

• Control the vacuum

  • "return rover to base"
  • "start rover"

• Use timers

  • “Create a timer for 5 minutes”
  • “Create a 15-minute timer for pizza”
  • “Cancel my timer”
  • “Pause my timer”
  • “Resume my timer”
  • “Add 2 minutes to my 5-minute timer”
  • “Remove 3 minutes from my pizza timer”

• Combine timers and device control to add a delay Unlike regular voice timers, delayed commands cannot be canceled or modified.

  • “Turn off the lights in the living room in 5 minutes”
  • “Pause TV in 10 minutes”
  • “Open the blinds in 5 minutes”

• Abort wake word

  • "Nevermind": If you triggered the wake word by mistake and want to stop Home Assistant from listening

The sentences only work, if the {% term entities %} are available and are named exactly the way you call them. Check the troubleshooting section to see common errors when asking for the weather forecast.

In addition to individual {% term entities %}, commands can target areas:

• "turn on all lights in the living room"
• "open windows in the kitchen"
• "change office brightness to 50%"
• "set bedroom lights to green"

Entity aliases are also matched so that multiple names can be used, even in different languages.

You can extend the built-in sentences or add your own to trigger any action in Home Assistant.

View existing sentences

The list of supported sentences is constantly being updated for each language. There are so many possible sentences that they cannot be all listed here. To find out what works in your language, follow these steps.

Note: If the voice assistant doesn't understand you, you may need to rephrase your sentence a bit. Or check if the {% term entity %} or {% term area %} name is correct for your environment.

1. Take a look at the test sentences:

   • On GitHub, in the tests folder, open the subfolder for your language.

   • Look through the test files to see the example sentences that have been tested.

   • The second part of the file name shows the {% term intent %}, the first part shows the {% term domain %}. For some {% term domains %}, such as covers, fans, and light, there are specific sentences. The other {% term domains %} are covered by the generic homeassistant_.

     

   • The screenshot below shows sentences used to test the command to turn on the lights. Note that Living room here is just a place holder. It could be any {% term area %} that you have in your home.

     

2. View the sentence definition for the tests:

   • On GitHub, in the sentences folder, open the subfolder for your language.

   • Open the file of interest.

     

     • () mean alternative elements.
     • [] mean optional elements.
     • <> mean an expansion rule. To view these rules, search for expansion_rules in the _common.yaml file.
     • The syntax is explained in detail in the template sentence syntax documentation.

3. View the sentence definition for your language.

4. View the response definition