ha-blueprints

Home Assistant YAML Blueprints

Blueprints are reusable automation templates with configurable inputs — users can create multiple automations from the same blueprint with different settings.

YAML Style Rules

• 2-space indentation (never tabs)
• Lowercase booleans: true / false

Blueprint Template

blueprint:
  name: 'Motion-Activated Light'
  description: 'Turn on light when motion detected, turn off after delay'
  domain: automation
  input:
    motion_entity:
      name: 'Motion Sensor'
      selector:
        entity:
          filter:
            domain: binary_sensor
            device_class: motion
    light_target:
      name: 'Light'
      selector:
        target:
          entity:
            filter:
              domain: light
    no_motion_wait:
      name: 'Wait time after motion stops'
      default: 120
      selector:
        number:
          min: 0
          max: 3600
          unit_of_measurement: seconds

trigger:
  - trigger: state
    entity_id: !input motion_entity
    to: 'on'

action:
  - action: light.turn_on
    target: !input light_target
  - wait_for_trigger:
      - trigger: state
        entity_id: !input motion_entity
        to: 'off'
  - delay:
      seconds: !input no_motion_wait
  - action: light.turn_off
    target: !input light_target

mode: restart

Key Blueprint Concepts

• !input — References a user-provided input value anywhere in the blueprint body
• selector — Controls what UI picker appears in HA's frontend for each input
• domain: automation — Blueprints can also target script domain
• default — Makes an input optional (uses default if not set)

Common Selectors

# Entity picker
selector:
  entity:
    filter:
      domain: light

# Area picker
selector:
  area: {}

# Number slider
selector:
  number:
    min: 0
    max: 100
    unit_of_measurement: "%"

# Boolean toggle
selector:
  boolean: {}

# Time picker
selector:
  time: {}

Sharing Blueprints