Input boolean

The Input boolean integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] lets you create a toggle helperA helper is a virtual entity you create inside Home Assistant. It is not backed by a physical device. Helpers store values, track state, or do calculations that your automations and dashboards need. [Learn more]: an entity that stores an on or off stateThe state holds the information of interest of an entity, for example, if a light is on or off. Each entity has exactly one state and the state only holds one value at a time. However, entities can store attributes related to that state such as brightness, color, or a unit of measurement. [Learn more] you can set yourself. Because the value is not tied to a physical device, you can use it as an adjustable switch for your automations, scripts, and dashboards. For example, you can create a toggle helper to enable or disable a set of automations, mark guest mode as active, or track whether you are on vacation.

On a dashboard, a toggle helper appears as a switch you can turn on or off. Each time the value changes, Home Assistant records a new state, which you can use as a trigger or a conditionConditions are an optional part of an automation that will prevent an action from firing if they are not met. [Learn more] in your automations. Your automations and scripts can also change the value, which makes a toggle helper a convenient way to share a setting between the user interface and your automations.

Configuration

1. Go to Settings > Devices & services > Helpers, and select Create helper.
2. Select Toggle.

Input booleans can also be configured via configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file:

# Example configuration.yaml entry
input_boolean:
  notify_home:
    name: Notify when someone arrives home
    icon: mdi:car

List of actions

The Input boolean integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following actions. Each link below opens a dedicated page with examples, parameters, and a step-by-step UI walkthrough.

• Reload input booleans (input_boolean.reload) Reloads the input boolean helpers from the YAML configuration.

• Toggle input boolean (input_boolean.toggle) Toggles an input boolean between on and off.

• Turn off input boolean (input_boolean.turn_off) Turns an input boolean off.

• Turn on input boolean (input_boolean.turn_on) Turns an input boolean on.

For an overview of every action across all integrations, see the actions reference.

Restore state

If you set a valid value for initial this integration will start with the state set to that value. Otherwise, it will restore the state it had before Home Assistant stopping; if there is no state to restore - an off value is set.

Automation examples

Here’s an example of an automation using the above input_boolean. This action will only occur if the input_boolean is on.

automation:
  alias: "Arriving home"
  triggers:
    - trigger: state
      entity_id: binary_sensor.motion_garage
      to: "on"
  conditions:
    - condition: state
      entity_id: input_boolean.notify_home
      state: "on"
  actions:
    - action: notify.pushbullet
      data:
        title: ""
        message: "Honey, I'm home!"

You can also set or change the status of an input_boolean by using input_boolean.turn_on, input_boolean.turn_off or input_boolean.toggle in your automation action.

action: input_boolean.turn_on
target:
  entity_id: input_boolean.notify_home

Troubleshooting

The toggle helper option is missing from the user interface

Symptom

When you go to Settings > Devices & services > Helpers to add a helper, the Toggle option is not listed.

Description

Toggle helpers are available when default_config: is enabled (this is the default), or when you configure input_boolean: manually in your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more]. If you removed default_config: and have not configured input_boolean:, the option is no longer available.

Resolution

1. Add input_boolean: to your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more].
2. Restart Home Assistant.
3. After the restart, create your toggle helpers from the user interface.