home-assistant.io/source/_integrations/humidifier.markdown

title	description	ha_category	ha_release	ha_domain	ha_quality_scale	ha_codeowners	ha_integration_type	related
Humidifier	Instructions on how to set up humidity control devices within Home Assistant.	Humidifier	0.112	humidifier	internal	@home-assistant/core @Shulyaka	entity	docs title /docs/configuration/customizing-devices/ Customizing devices docs title /dashboards/ Dashboard

The Humidifier {% term integration %} is built for the controlling and monitoring of humidifiers, dehumidifiers, and hygrostat devices.

{% include integrations/building_block_integration.md %}

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

{% include integrations/device_class_intro.md %}

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. {% endtip %}

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.