Skip to content

Flags 1.0.0+ ​

Flags are simple boolean markers that represent a certain state in your home.
A flag is always either on (true) or off (false), and you can get, set, or toggle it from any flow.

Typical examples include:

  • A vacation flag.
  • A guest mode flag.
  • A quiet hours flag.
  • A heating override flag.

Flags make it easy to model small pieces of household state without needing variables or complex logic.

How it works ​

A flag is a named state indicator.
You set it to reflect the situation in your home, and your flows can react accordingly.

Flags are ideal for:

  • Marking whether a situation is active.
  • Representing temporary household states.
  • Coordinating behavior across multiple flows.
  • Providing a single source of truth for simple on/off conditions.

Flow cards ​

These flow cards allow you to set, clear, toggle, or evaluate flags from within your flows, giving you a simple way to mark and use boolean state.

Actions ​

FlowBits
Activate flag Partytime
Activate a flag, but only if it is not already active.
FlowBits
Activate flag Guest mode for 3 hours
Activate a flag for a specified duration, then automatically deactivate it.
FlowBits
Deactivate flag Cleaning
Deactivate a flag, but only if it is active.
FlowBits
Toggle flag Vacation
Toggle a flag, regardless of its current state.

Conditions ​

FlowBits
Flag Cleaning is active
Check if a flag is active.
FlowBits
Flag Vacation is active for at least 2 days
Check if a flag has been active for at least the specified duration.
FlowBits
Flag Partytime is inactive for at least 30 minutes
Check if a flag has been inactive for at least the specified duration.

Triggers ​

FlowBits
Flag Partytime is activated
Triggers when a flag is activated.
FlowBits
Flag Vacation changed
Triggers when a flag is activated or deactivated.
FlowBits
Flag Cleaning is deactivated
Triggers when a flag is deactivated.

Examples ​

Vacation mode ​

Turn the “vacation” flag on when you leave home.
Other flows can react by adjusting heating, disabling routines, or activating security automations.

Guest mode ​

Use a “guest_mode” flag to temporarily override automations like motion lighting or door alerts.

Quiet hours ​

Enable a “quiet_hours” flag at night to reduce notifications or dim lights.

Notes ​

  • Flags are global and can be used in any flow.
  • Flags persist across reboots.
  • Use descriptive names to keep your system organized.
  • The duration-based conditions can be inverted (using the condition's invert option) to check for "less than" instead of "at least".