Triggers

Triggers are what start an automation. They fire when something happens in your home, like a light turning on, a door opening, or the sun setting. When a trigger fires, the automation checks its conditions and then runs its actions.

Browse the full list below, or use the search box to find a specific trigger by name or description. Each trigger has its own page with a step-by-step UI walkthrough, examples, and a complete field reference.

New to triggers? Read about triggers in automations to learn how they fit together with conditions and actions.

Air quality

Carbon dioxide level changed air_quality.co2_changed Triggers after one or more carbon dioxide levels change.
Carbon dioxide level crossed threshold air_quality.co2_crossed_threshold Triggers after one or more carbon dioxide levels cross a threshold.
Carbon monoxide level changed air_quality.co_changed Triggers after one or more carbon monoxide levels change.
Carbon monoxide cleared air_quality.co_cleared Triggers after one or more carbon monoxide sensors stop detecting carbon monoxide.
Carbon monoxide level crossed threshold air_quality.co_crossed_threshold Triggers after one or more carbon monoxide levels cross a threshold.
Carbon monoxide detected air_quality.co_detected Triggers after one or more carbon monoxide sensors start detecting carbon monoxide.
Gas cleared air_quality.gas_cleared Triggers after one or more gas sensors stop detecting gas.
Gas detected air_quality.gas_detected Triggers after one or more gas sensors start detecting gas.
Nitrous oxide level changed air_quality.n2o_changed Triggers after one or more nitrous oxide levels change.
Nitrous oxide level crossed threshold air_quality.n2o_crossed_threshold Triggers after one or more nitrous oxide levels cross a threshold.
Nitrogen dioxide level changed air_quality.no2_changed Triggers after one or more nitrogen dioxide levels change.
Nitrogen dioxide level crossed threshold air_quality.no2_crossed_threshold Triggers after one or more nitrogen dioxide levels cross a threshold.
Nitrogen monoxide level changed air_quality.no_changed Triggers after one or more nitrogen monoxide levels change.
Nitrogen monoxide level crossed threshold air_quality.no_crossed_threshold Triggers after one or more nitrogen monoxide levels cross a threshold.
Ozone level changed air_quality.ozone_changed Triggers after one or more ozone levels change.
Ozone level crossed threshold air_quality.ozone_crossed_threshold Triggers after one or more ozone levels cross a threshold.
PM10 level changed air_quality.pm10_changed Triggers after one or more PM10 levels change.
PM10 level crossed threshold air_quality.pm10_crossed_threshold Triggers after one or more PM10 levels cross a threshold.
PM1 level changed air_quality.pm1_changed Triggers after one or more PM1 levels change.
PM1 level crossed threshold air_quality.pm1_crossed_threshold Triggers after one or more PM1 levels cross a threshold.
PM2.5 level changed air_quality.pm25_changed Triggers after one or more PM2.5 levels change.
PM2.5 level crossed threshold air_quality.pm25_crossed_threshold Triggers after one or more PM2.5 levels cross a threshold.
PM4 level changed air_quality.pm4_changed Triggers after one or more PM4 levels change.
PM4 level crossed threshold air_quality.pm4_crossed_threshold Triggers after one or more PM4 levels cross a threshold.
Smoke cleared air_quality.smoke_cleared Triggers after one or more smoke sensors stop detecting smoke.
Smoke detected air_quality.smoke_detected Triggers after one or more smoke sensors start detecting smoke.
Sulphur dioxide level changed air_quality.so2_changed Triggers after one or more sulphur dioxide levels change.
Sulphur dioxide level crossed threshold air_quality.so2_crossed_threshold Triggers after one or more sulphur dioxide levels cross a threshold.
Volatile organic compounds level changed air_quality.voc_changed Triggers after one or more volatile organic compound levels change.
Volatile organic compounds level crossed threshold air_quality.voc_crossed_threshold Triggers after one or more volatile organic compounds levels cross a threshold.
Volatile organic compounds ratio changed air_quality.voc_ratio_changed Triggers after one or more volatile organic compound ratios change.
Volatile organic compounds ratio crossed threshold air_quality.voc_ratio_crossed_threshold Triggers after one or more volatile organic compounds ratios cross a threshold.

Alarm control panel

Alarm armed alarm_control_panel.armed Triggers after one or more alarms become armed, regardless of the mode.
Alarm armed away alarm_control_panel.armed_away Triggers after one or more alarms become armed in away mode.
Alarm armed home alarm_control_panel.armed_home Triggers after one or more alarms become armed in home mode.
Alarm armed night alarm_control_panel.armed_night Triggers after one or more alarms become armed in night mode.
Alarm armed vacation alarm_control_panel.armed_vacation Triggers after one or more alarms become armed in vacation mode.
Alarm disarmed alarm_control_panel.disarmed Triggers after one or more alarms become disarmed.
Alarm triggered alarm_control_panel.triggered Triggers after one or more alarms become triggered.

Battery

Battery level changed battery.level_changed Triggers after one or more battery level readings change.
Battery level crossed threshold battery.level_crossed Triggers after one or more battery level readings cross a threshold.
Battery low battery.low Triggers after one or more battery sensors report a low battery.
Battery not low battery.not_low Triggers after one or more battery sensors stop reporting a low battery.
Battery started charging battery.started_charging Triggers after one or more battery-powered devices start charging.
Battery stopped charging battery.stopped_charging Triggers after one or more battery-powered devices stop charging.

Button

Button pressed button.pressed Runs when a button entity is pressed.

Calendar

Calendar event ended calendar.event_ended Triggers when a calendar event ends.
Calendar event started calendar.event_started Triggers when a calendar event starts.

Climate

Thermostat mode changed climate.hvac_mode_changed Triggers after the HVAC mode of one or more climate devices changes.
Thermostat started cooling climate.started_cooling Triggers after one or more thermostats start cooling.
Thermostat started drying climate.started_drying Triggers after one or more thermostats start drying.
Thermostat started heating climate.started_heating Triggers after one or more thermostats start heating.
Thermostat target humidity changed climate.target_humidity_changed Triggers after the humidity setpoint of one or more thermostats changes.
Thermostat target humidity crossed threshold climate.target_humidity_crossed_threshold Triggers after the humidity setpoint of one or more thermostats crosses a threshold.
Thermostat target temperature changed climate.target_temperature_changed Triggers after the temperature setpoint of one or more thermostats changes.
Thermostat target temperature crossed threshold climate.target_temperature_crossed_threshold Triggers after the temperature setpoint of one or more thermostats crosses a threshold.
Thermostat turned off climate.turned_off Triggers after one or more climate devices turn off.
Thermostat turned on climate.turned_on Triggers after one or more climate devices turn on, regardless of the mode.

Counter

Counter decremented counter.decremented Triggers after one or more counters decrement.
Counter incremented counter.incremented Triggers after one or more counters increment.
Counter reached maximum counter.maximum_reached Triggers after one or more counters reach their maximum value.
Counter reached minimum counter.minimum_reached Triggers after one or more counters reach their minimum value.
Counter reset counter.reset Triggers after one or more counters are reset.

Door

Door closed door.closed Triggers after one or more doors close.
Door opened door.opened Triggers after one or more doors open.

Fan

Fan turned off fan.turned_off Triggers after one or more fans turn off.
Fan turned on fan.turned_on Triggers after one or more fans turn on.

Garage door

Garage door closed garage_door.closed Triggers after one or more garage doors close.
Garage door opened garage_door.opened Triggers after one or more garage doors open.

Gate

Gate closed gate.closed Triggers after one or more gates close.
Gate opened gate.opened Triggers after one or more gates open.

Home Assistant Core

Manual event received event Triggers when an event is received.
Home Assistant homeassistant Triggers when Home Assistant starts up or shuts down.
Numeric state numeric_state Triggers when a numeric value crosses a threshold.
State state Triggers when the state or an attribute changes.
Time time Triggers at a specific time, or from a date/time helper or timestamp-style sensor.
Time pattern time_pattern Triggers periodically at a defined interval.

Humidifier

Humidifier mode changed humidifier.mode_changed Triggers after the mode of one or more humidifiers changes.
Humidifier started drying humidifier.started_drying Triggers after one or more humidifiers start actively drying (dehumidifying).
Humidifier started humidifying humidifier.started_humidifying Triggers after one or more humidifiers start actively humidifying.
Humidifier turned off humidifier.turned_off Triggers after one or more humidifiers turn off.
Humidifier turned on humidifier.turned_on Triggers after one or more humidifiers turn on.

Humidity

Relative humidity changed humidity.changed Triggers after one or more relative humidity readings change.
Relative humidity crossed threshold humidity.crossed_threshold Triggers after one or more relative humidity readings cross a threshold.

Illuminance

Illuminance changed illuminance.changed Triggers after one or more illuminance values change.
Light cleared illuminance.cleared Triggers after one or more light sensors stop detecting light.
Illuminance crossed threshold illuminance.crossed_threshold Triggers after one or more illuminance values cross a threshold.
Light detected illuminance.detected Triggers after one or more light sensors start detecting light.

Lawn mower

Lawn mower returned to dock lawn_mower.docked Triggers after one or more lawn mowers have returned to dock.
Lawn mower encountered an error lawn_mower.errored Triggers after one or more lawn mowers encounter an error.
Lawn mower paused mowing lawn_mower.paused_mowing Triggers after one or more lawn mowers pause mowing.
Lawn mower started mowing lawn_mower.started_mowing Triggers after one or more lawn mowers start mowing.
Lawn mower started returning to dock lawn_mower.started_returning Triggers after one or more lawn mowers start returning to dock.

Light

Light brightness changed light.brightness_changed Triggers after the brightness of one or more lights changes.
Light brightness crossed threshold light.brightness_crossed_threshold Triggers after the brightness of one or more lights crosses a threshold.
Light turned off light.turned_off Triggers after one or more lights turn off.
Light turned on light.turned_on Triggers after one or more lights turn on.

Lock

Lock jammed lock.jammed Triggers after one or more locks jam.
Lock locked lock.locked Triggers after one or more locks lock.
Lock opened lock.opened Triggers after one or more locks open.
Lock unlocked lock.unlocked Triggers after one or more locks unlock.

Moisture

Moisture content changed moisture.changed Triggers after one or more moisture content values change.
Moisture cleared moisture.cleared Triggers after one or more moisture sensors stop detecting moisture.
Moisture content crossed threshold moisture.crossed_threshold Triggers after one or more moisture content values cross a threshold.
Moisture detected moisture.detected Triggers after one or more moisture sensors start detecting moisture.

Motion

Motion cleared motion.cleared Triggers after one or more motion sensors stop detecting motion.
Motion detected motion.detected Triggers after one or more motion sensors start detecting motion.

Siren

Siren turned off siren.turned_off Triggers after one or more sirens turn off.
Siren turned on siren.turned_on Triggers after one or more sirens turn on.

Temperature

Temperature changed temperature.changed Triggers after one or more temperature readings change.
Temperature crossed threshold temperature.crossed_threshold Triggers after one or more temperature readings cross a threshold.

Timer

Timer cancelled timer.cancelled Triggers when one or more timers are cancelled.
Timer finished timer.finished Triggers when one or more timers finish.
Timer paused timer.paused Triggers when one or more timers are paused.
Timer restarted timer.restarted Triggers when one or more timers are restarted.
Timer started timer.started Triggers when one or more timers are started.
Timer time remaining timer.time_remaining Triggers when one or more timers reach a specific remaining time.

To-do list

To-do item added todo.item_added Triggers when a to-do item is added to a list.
To-do item completed todo.item_completed Triggers when a to-do item is marked as done.
To-do item removed todo.item_removed Triggers when a to-do item is removed from a list.

Update

Update became available update.update_became_available Triggers after one or more updates become available.

Vacuum

Vacuum returned to dock vacuum.docked Triggers when a vacuum cleaner docks.
Vacuum encountered an error vacuum.errored Triggers when a vacuum cleaner reports an error.
Vacuum paused cleaning vacuum.paused_cleaning Triggers when a vacuum cleaner pauses cleaning.
Vacuum started cleaning vacuum.started_cleaning Triggers when a vacuum cleaner begins a cleaning task.
Vacuum started returning to dock vacuum.started_returning Triggers when a vacuum cleaner begins returning to its dock.

Valve

Valve closed valve.closed Triggers after one or more valves close.
Valve opened valve.opened Triggers after one or more valves open.

Window

Window closed window.closed Triggers after one or more windows close.
Window opened window.opened Triggers after one or more windows open.

air_quality.co2_changed - Triggers after one or more carbon dioxide levels change.

air_quality.co2_crossed_threshold - Triggers after one or more carbon dioxide levels cross a threshold.

air_quality.co_changed - Triggers after one or more carbon monoxide levels change.

air_quality.co_cleared - Triggers after one or more carbon monoxide sensors stop detecting carbon monoxide.

air_quality.co_crossed_threshold - Triggers after one or more carbon monoxide levels cross a threshold.

air_quality.co_detected - Triggers after one or more carbon monoxide sensors start detecting carbon monoxide.

air_quality.gas_cleared - Triggers after one or more gas sensors stop detecting gas.

air_quality.gas_detected - Triggers after one or more gas sensors start detecting gas.

air_quality.n2o_changed - Triggers after one or more nitrous oxide levels change.

air_quality.n2o_crossed_threshold - Triggers after one or more nitrous oxide levels cross a threshold.

air_quality.no2_changed - Triggers after one or more nitrogen dioxide levels change.

air_quality.no2_crossed_threshold - Triggers after one or more nitrogen dioxide levels cross a threshold.

air_quality.no_changed - Triggers after one or more nitrogen monoxide levels change.

air_quality.no_crossed_threshold - Triggers after one or more nitrogen monoxide levels cross a threshold.

air_quality.ozone_changed - Triggers after one or more ozone levels change.

air_quality.ozone_crossed_threshold - Triggers after one or more ozone levels cross a threshold.

air_quality.pm10_changed - Triggers after one or more PM10 levels change.

air_quality.pm10_crossed_threshold - Triggers after one or more PM10 levels cross a threshold.

air_quality.pm1_changed - Triggers after one or more PM1 levels change.

air_quality.pm1_crossed_threshold - Triggers after one or more PM1 levels cross a threshold.

air_quality.pm25_changed - Triggers after one or more PM2.5 levels change.

air_quality.pm25_crossed_threshold - Triggers after one or more PM2.5 levels cross a threshold.

air_quality.pm4_changed - Triggers after one or more PM4 levels change.

air_quality.pm4_crossed_threshold - Triggers after one or more PM4 levels cross a threshold.

air_quality.smoke_cleared - Triggers after one or more smoke sensors stop detecting smoke.

air_quality.smoke_detected - Triggers after one or more smoke sensors start detecting smoke.

air_quality.so2_changed - Triggers after one or more sulphur dioxide levels change.

air_quality.so2_crossed_threshold - Triggers after one or more sulphur dioxide levels cross a threshold.

air_quality.voc_changed - Triggers after one or more volatile organic compound levels change.

air_quality.voc_crossed_threshold - Triggers after one or more volatile organic compounds levels cross a threshold.

air_quality.voc_ratio_changed - Triggers after one or more volatile organic compound ratios change.

air_quality.voc_ratio_crossed_threshold - Triggers after one or more volatile organic compounds ratios cross a threshold.

alarm_control_panel.armed - Triggers after one or more alarms become armed, regardless of the mode.

alarm_control_panel.armed_away - Triggers after one or more alarms become armed in away mode.

alarm_control_panel.armed_home - Triggers after one or more alarms become armed in home mode.

alarm_control_panel.armed_night - Triggers after one or more alarms become armed in night mode.

alarm_control_panel.armed_vacation - Triggers after one or more alarms become armed in vacation mode.

alarm_control_panel.disarmed - Triggers after one or more alarms become disarmed.

alarm_control_panel.triggered - Triggers after one or more alarms become triggered.

battery.level_changed - Triggers after one or more battery level readings change.

battery.level_crossed - Triggers after one or more battery level readings cross a threshold.

battery.low - Triggers after one or more battery sensors report a low battery.

battery.not_low - Triggers after one or more battery sensors stop reporting a low battery.

battery.started_charging - Triggers after one or more battery-powered devices start charging.

battery.stopped_charging - Triggers after one or more battery-powered devices stop charging.

button.pressed - Runs when a button entity is pressed.

calendar.event_ended - Triggers when a calendar event ends.

calendar.event_started - Triggers when a calendar event starts.

climate.hvac_mode_changed - Triggers after the HVAC mode of one or more climate devices changes.

climate.started_cooling - Triggers after one or more thermostats start cooling.

climate.started_drying - Triggers after one or more thermostats start drying.

climate.started_heating - Triggers after one or more thermostats start heating.

climate.target_humidity_changed - Triggers after the humidity setpoint of one or more thermostats changes.

climate.target_humidity_crossed_threshold - Triggers after the humidity setpoint of one or more thermostats crosses a threshold.

climate.target_temperature_changed - Triggers after the temperature setpoint of one or more thermostats changes.

climate.target_temperature_crossed_threshold - Triggers after the temperature setpoint of one or more thermostats crosses a threshold.

climate.turned_off - Triggers after one or more climate devices turn off.

climate.turned_on - Triggers after one or more climate devices turn on, regardless of the mode.

counter.decremented - Triggers after one or more counters decrement.

counter.incremented - Triggers after one or more counters increment.

counter.maximum_reached - Triggers after one or more counters reach their maximum value.

counter.minimum_reached - Triggers after one or more counters reach their minimum value.

counter.reset - Triggers after one or more counters are reset.

door.closed - Triggers after one or more doors close.

door.opened - Triggers after one or more doors open.

event - Triggers when an event is received.

fan.turned_off - Triggers after one or more fans turn off.

fan.turned_on - Triggers after one or more fans turn on.

garage_door.closed - Triggers after one or more garage doors close.

garage_door.opened - Triggers after one or more garage doors open.

gate.closed - Triggers after one or more gates close.

gate.opened - Triggers after one or more gates open.

homeassistant - Triggers when Home Assistant starts up or shuts down.

humidifier.mode_changed - Triggers after the mode of one or more humidifiers changes.

humidifier.started_drying - Triggers after one or more humidifiers start actively drying (dehumidifying).

humidifier.started_humidifying - Triggers after one or more humidifiers start actively humidifying.

humidifier.turned_off - Triggers after one or more humidifiers turn off.

humidifier.turned_on - Triggers after one or more humidifiers turn on.

humidity.changed - Triggers after one or more relative humidity readings change.

humidity.crossed_threshold - Triggers after one or more relative humidity readings cross a threshold.

illuminance.changed - Triggers after one or more illuminance values change.

illuminance.cleared - Triggers after one or more light sensors stop detecting light.

illuminance.crossed_threshold - Triggers after one or more illuminance values cross a threshold.

illuminance.detected - Triggers after one or more light sensors start detecting light.

lawn_mower.docked - Triggers after one or more lawn mowers have returned to dock.

lawn_mower.errored - Triggers after one or more lawn mowers encounter an error.

lawn_mower.paused_mowing - Triggers after one or more lawn mowers pause mowing.

lawn_mower.started_mowing - Triggers after one or more lawn mowers start mowing.

lawn_mower.started_returning - Triggers after one or more lawn mowers start returning to dock.

light.brightness_changed - Triggers after the brightness of one or more lights changes.

light.brightness_crossed_threshold - Triggers after the brightness of one or more lights crosses a threshold.

light.turned_off - Triggers after one or more lights turn off.

light.turned_on - Triggers after one or more lights turn on.

lock.jammed - Triggers after one or more locks jam.

lock.locked - Triggers after one or more locks lock.

lock.opened - Triggers after one or more locks open.

lock.unlocked - Triggers after one or more locks unlock.

moisture.changed - Triggers after one or more moisture content values change.

moisture.cleared - Triggers after one or more moisture sensors stop detecting moisture.

moisture.crossed_threshold - Triggers after one or more moisture content values cross a threshold.

moisture.detected - Triggers after one or more moisture sensors start detecting moisture.

motion.cleared - Triggers after one or more motion sensors stop detecting motion.

motion.detected - Triggers after one or more motion sensors start detecting motion.

numeric_state - Triggers when a numeric value crosses a threshold.

siren.turned_off - Triggers after one or more sirens turn off.

siren.turned_on - Triggers after one or more sirens turn on.

state - Triggers when the state or an attribute changes.

temperature.changed - Triggers after one or more temperature readings change.

temperature.crossed_threshold - Triggers after one or more temperature readings cross a threshold.

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

time_pattern - Triggers periodically at a defined interval.

timer.cancelled - Triggers when one or more timers are cancelled.

timer.finished - Triggers when one or more timers finish.

timer.paused - Triggers when one or more timers are paused.

timer.restarted - Triggers when one or more timers are restarted.

timer.started - Triggers when one or more timers are started.

timer.time_remaining - Triggers when one or more timers reach a specific remaining time.

todo.item_added - Triggers when a to-do item is added to a list.

todo.item_completed - Triggers when a to-do item is marked as done.

todo.item_removed - Triggers when a to-do item is removed from a list.

update.update_became_available - Triggers after one or more updates become available.

vacuum.docked - Triggers when a vacuum cleaner docks.

vacuum.errored - Triggers when a vacuum cleaner reports an error.

vacuum.paused_cleaning - Triggers when a vacuum cleaner pauses cleaning.

vacuum.started_cleaning - Triggers when a vacuum cleaner begins a cleaning task.

vacuum.started_returning - Triggers when a vacuum cleaner begins returning to its dock.

valve.closed - Triggers after one or more valves close.

valve.opened - Triggers after one or more valves open.

window.closed - Triggers after one or more windows close.

window.opened - Triggers after one or more windows open.