State

The State trigger is useful when you want an automation to react to a change in an entity or one of its attributes. Use it when you care about a device turning on or off, a door opening or closing, or a person arriving home.

Using this trigger from the user interface

If you prefer building automations visually, Home Assistant walks you through this trigger step by step. You pick what to watch, tweak a few options, and save. No YAML knowledge required.

To use this trigger in an automation:

1. Go to Settings > Automations & scenes.
2. Open an existing automation, or select Create automation > Create new automation.
3. In the When section, select Add trigger.
4. Select the type of trigger to add.
5. Select State.
6. In Entity, select the entity whose state Home Assistant should watch.
7. If you want to pick another entity, select Add entity and then select it from the list.
8. Optional: In Attribute, select an attribute instead of the main state.
9. Optional: In From, enter the state (or attribute value) the entity must have before the trigger fires.
10. Optional: In To, enter the state (or attribute value) the entity must have when the trigger fires.
11. Optional: In For, enter how long the entity must be in the new state, or hold the new attribute value, before the trigger fires. Instead of a Duration, you can enter a Template.
12. Select Save.

Options in the UI

Using this trigger in YAML

If you work directly in YAML, or you want to know exactly what Home Assistant does under the hood, this section has the technical reference. It lists the field names you use in YAML, their types, and which ones are required.

In YAML, use trigger: state. A basic example looks like this:

trigger: state
entity_id: binary_sensor.front_door
to: "on"

This runs when the front door changes to on.

Options in YAML

Targets of the trigger

This trigger watches one or more entities:

• Use the UI option Entity, or YAML option entity_id, to watch one entity.
• Select Add entity and pick another entity from the UI, or use a list of entity_id values in YAML, to watch more than one entity.

Good to know

• If you do not set any of From, To, not_from, or not_to, this trigger fires on all state changes. It also fires when only an attribute changes.
• If you set one of the options From (from), To (to), not_from, or not_to, attribute-only changes do not fire the trigger.
• You cannot combine the options from with not_from, or to with not_to.
• If you use the For (for) option, the timer resets if Home Assistant restarts or automations reload.

Try it yourself

Ready to test this? Go to Settings > Automations & scenes, create a new automation, and add this trigger. Save the automation, then change the state of the targeted entity to watch the trigger fire on your actual entitiesAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more].

More examples

Real scenarios where this trigger fires in automations and scripts. Copy any example and adapt it to your setup.

Automation: send a reminder when a door stays open for 5 minutes

If a door stays open longer than expected, this automation sends a message to your phone.

• Trigger: State
  • Entity: Back door sensor (binary_sensor.back_door)
  • To: On
  • For: 5 minutes
• Action: Send a notification message
  • Target: My Device (notify.my_device)

alias: "Remind me when the back door stays open"
triggers:
  - trigger: state
    entity_id: binary_sensor.back_door
    to: "on"
    for: "00:05:00"
actions:
  - action: notify.send_message
    target:
      entity_id: notify.my_device
    data:
      message: "The back door has been open for 5 minutes."

Automation: send a notification when someone arrives home

If you want a message when a person arrives, this automation watches for a state change to home.

• Trigger: State
  • Entity: Person entity (person.sam)
  • To: Home
• Action: Send a notification message
  • Target: My Device (notify.my_device)

alias: "Notify me when Sam arrives home"
triggers:
  - trigger: state
    entity_id: person.sam
    to: "home"
actions:
  - action: notify.send_message
    target:
      entity_id: notify.my_device
    data:
      message: "Sam has arrived home."

Still stuck?

The Home Assistant community is quick to help: join Discord for real-time chat, post on the community forum with the trigger you’re using and what you expected to happen, or share on our subreddit /r/homeassistant.

Related triggers

These triggers work well alongside this one:

• Numeric state: Triggers when a numeric value crosses a threshold.

• Time: Triggers at a specific time, or from a date/time helper or timestamp-style sensor.