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".