Automation Modes


An automation can be triggered while it is already running.

The automation’s mode configuration option controls what happens when the automation is triggered while the actions are still running from a previous trigger.

Mode Description
single (Default) Do not start a new run. Issue a warning.
restart Start a new run after first stopping the previous run. The automation only restarts if the conditions are met.
queued Start a new run after all previous runs complete. Runs are guaranteed to execute in the order they were queued. Note that subsequent queued automations will only join the queue if any conditions it may have are met at the time it is triggered.
parallel Start a new, independent run in parallel with previous runs.

For both queued and parallel modes, configuration option max controls the maximum number of runs that can be executing and/or queued up at a time. The default is 10.

When max is exceeded (which is effectively 1 for single mode) a log message will be emitted to indicate this has happened. Configuration option max_exceeded controls the severity level of that log message. Set it to silent to ignore warnings or set it to a log level. The default is warning.

Example throttled automation

Some automations you only want to run every 5 minutes. This can be achieved using the single mode and silencing the warnings when the automation is triggered while it’s running.

automation:
  - mode: single
    max_exceeded: silent
    trigger:
      - ...
    action:
      - ...
      - delay: 300  # seconds (=5 minutes)

Example Queued

Sometimes an automation is doing an action on a device that does not support multiple simultaneous actions. In such cases, a queue can be used. In that case, the automation will be executed once it’s current invocation and queue are done.

automation:
  - mode: queued
    max: 25
    trigger:
      - ...
    action:
      - ...