ha-yaml-automations

Home Assistant YAML Automations

YAML Style Rules

• 2-space indentation (never tabs)
• Lowercase booleans: true / false
• Entity IDs: domain.entity_name (lowercase, underscores)

Automation Template

automation:
  - id: 'unique_automation_id'
    alias: 'Descriptive Name'
    description: 'What this does'
    mode: single # see Run Modes below; defaults to single if omitted
    triggers:
      - trigger: state
        entity_id: binary_sensor.front_door
        to: 'on'
    conditions:
      - condition: time
        after: '08:00:00'
        before: '22:00:00'
    actions:
      - action: light.turn_on
        target:
          entity_id: light.hallway
        data:
          brightness_pct: 100

Run Modes

mode: controls what happens when the automation is triggered again while a previous run is still going. Omitting it defaults to single.

• single — ignore the new trigger; the in-progress run continues uninterrupted (default).
• restart — cancel the running run and start over from the top.
• queued — run sequentially; each new trigger waits in line and runs after the previous one finishes.
• parallel — run concurrently; each trigger starts its own run immediately.

Common Triggers

# State
- trigger: state
  entity_id: sensor.temperature
  above: 25

# Time
- trigger: time
  at: '07:30:00'

# Sun
- trigger: sun
  event: sunset
  offset: '-00:30:00'

# Template
- trigger: template
  value_template: "{{ states('sensor.power') | float > 1000 }}"

# Webhook
- trigger: webhook
  webhook_id: 'my_unique_webhook_id'
  allowed_methods: [POST]

Common Conditions

# State
- condition: state
  entity_id: alarm_control_panel.home
  state: 'armed_away'

# Numeric
- condition: numeric_state
  entity_id: sensor.temperature
  above: 20
  below: 30

# Time
- condition: time
  after: '08:00:00'
  before: '23:00:00'
  weekday: [mon, tue, wed, thu, fri]

# Template
- condition: template
  value_template: "{{ is_state('person.john', 'home') }}"

# AND/OR
- condition: and
  conditions:
    - condition: state
      entity_id: input_boolean.guest_mode
      state: 'off'
    - condition: state
      entity_id: binary_sensor.motion
      state: 'on'