2024.11.2
Home ▸ Integrations ▸

Humidifier

The Humidifier integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] is built for the controlling and monitoring of humidifiers, dehumidifiers, and hygrostat devices.

Note

Building block integration

This humidifier is a building block integration that cannot be added to your Home Assistant directly but is used and provided by other integrations.

A building block integration differs from the typical integration that connects to a device or service. Instead, other integrations that do integrate a device or service into Home Assistant use this humidifier building block to provide entities, services, and other functionality that you can use in your automations or dashboards.

If one of your integrations features this building block, this page documents the functionality the humidifier building block offers.

The state of a humidifier entity

The state of a humidifier entity can be either On or Off.

In addition, the entity can have the following states:

  • Unavailable: The entity is currently unavailable.
  • Unknown: The state is not yet known.

Device class

A device class is a measurement categorization in Home Assistant. It influences how the entity is represented in the dashboard. This can be modified in the customize section. For example, different states may be represented by different icons, colors, or text.

The screenshot shows different text and UI for different device classes for humidifiers:

Humidifier device classes.

The following device classes are supported for humidifiers:

  • Humidifier: Adds humidity to the air around it.
  • Dehumidifier: Removes humidity from the air around it.

Actions

Humidifier actions

Available actions: humidifier.set_mode, humidifier.set_humidity, humidifier.turn_on, humidifier.turn_off, humidifier.toggle

Tip

Not all humidifier actions may be available for your platform. Be sure to check the available actions Home Assistant has enabled by checking the Actions page in the Developer Tools.

Action humidifier.set_mode

Set mode for the humidifier device. This action is only available if the device supports operating in several working modes. The list of available modes and the device functionality in every mode depend on the device itself.

Data attribute Optional Description
entity_id yes String or list of strings that point at entity_id’s of humidifier devices to control.
mode no New mode.

Automation example 

automation:
  triggers:
    - trigger: time
      at: "07:15:00"
  actions:
    - action: humidifier.set_mode
      target:
        entity_id: humidifier.bedroom
      data:
        mode: "eco"

Action humidifier.set_humidity

Set target humidity of the humidifier device

Data attribute Optional Description
entity_id yes String or list of strings that point at entity_id’s of humidifier devices to control.
humidity no New target humidity for humidifier device

Automation example 

automation:
  triggers:
    - trigger: time
      at: "07:15:00"
  actions:
    - action: humidifier.set_humidity
      target:
        entity_id: humidifier.bedroom
      data:
        humidity: 60

Action humidifier.turn_on

Turn the humidifier device on.

Data attribute Optional Description
entity_id yes String or list of strings that point at entity_id’s of humidifier devices to control.

Action humidifier.turn_off

Turn the humidifier device off.

Data attribute Optional Description
entity_id yes String or list of strings that point at entity_id’s of humidifier devices to control.

Action humidifier.toggle

Toggle the humidifier device on/off.

Data attribute Optional Description
entity_id yes String or list of strings that point at entity_id’s of humidifier devices to control.

Related topics