Text and templates

Write the text ​

Two things mix in the field. Home Assistant's templates fill in what changes. A little markup decides how it looks.

What changes ​

Everything between {{ }} and {% %} is Home Assistant's own template language. The template documentation of Home Assistant has everything it can do. These are the ones you use most:

How it looks ​

Outside the braces, each line is one row on the screen.

The keys under the field put each of these in for you. One line can have four parts in different colours. The screen has a fixed set of fonts, so there are no pictures, links or emoji. A character the fonts don't have shows as an empty box. The minus sign, dashes and curly quotes that sensors sometimes write are changed to plain ones for you.

Examples ​

A list that is only there when something needs doing. When nothing does, the tile disappears:

{% if is_state('sensor.dishwasher', 'done') %}
- Empty the **dishwasher**
{% endif %}
{% if is_state('binary_sensor.rinse_aid_low', 'on') %}
- :alert[Rinse aid] is low
{% endif %}

A small table:

## Energy
| | Now |
|---|---|
| Solar | {{ states('sensor.solar_power') | round(1) }} kW |
| Battery | {{ states('sensor.home_battery') }} % |

The editor helps you ​

• It completes as you type. After states(', is_state(' or state_attr(' it lists your entities, with their name and value. You can search by name too. After state_attr('climate.living_room', ' it lists that entity's attributes with their values. After is_state('lock.front_door', ' it lists the states the entity can have, the one it has now first.
• It knows Home Assistant. After | it lists the filters, after {% the tags such as if and for, and inside the braces the functions. states. lists your domains, and states.light. your lights.
• Tab fills in the rest. A function, a tag or a table comes with fields. Tab goes to the next field. A function that needs an entity opens the list of entities at once.
• It shows the values. A small label after states(…) and state_attr(…) shows the value now. A ✓ after is_state(…) says it's true now, and ✗ shows the state it has instead.
• It catches typos. An entity that Home Assistant doesn't have gets a wavy line. Point at it to see the entity it most likely meant, and press Replace with to fix it. When Home Assistant names a line in its error, that line is marked.
• It shows the result. On the screen shows the result the way the screen gets it, a moment after you stop typing, with how much of the tile's room it uses. An error shows Home Assistant's own message, on the screen too, until the template works.
• It says when it updates. Updates when names the entities the template reads. The tile updates as soon as one of them changes. A template that reads every state, such as states | count, updates at most once a minute; name the entities or a domain such as states.light to make it follow at once.
• Point at an entity to see its name and state. Ctrl+Space shows what fits where the cursor is. Ctrl+/ (⌘/ on a Mac) turns a line into a comment, {# … #}.