home-assistant-yaml-style

Use 2-space indentation, true/false booleans, block-style sequences, and double quotes for strings. Omit default values like mode: single and empty sections such as data: {}. Keep lines within 80 characters and format examples as if included in configuration.yaml.

Use the target block with entity_id, area_id, or device_id keys rather than placing entity IDs at the action level or inside data. The target syntax is the modern, flexible approach and supports combining multiple target types in one action.

Double quotes are preferred, but entity IDs, device classes, platform types, action names, and similar fixed-value identifiers may stay unquoted for readability. Templates must always be double-quoted with single quotes used inside the template expression.

Helper methods like states(), is_state(), state_attr(), and is_state_attr() avoid errors when an entity is not ready, such as during Home Assistant startup. Accessing the states object directly can raise exceptions in those situations.

Avoid templates when a pure YAML alternative exists, such as a numeric_state condition instead of a value template. When templates are needed, prefer shorthand style, split long expressions across lines, and space around the filter pipe marker.