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.
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.
Humidifier states
A humidifier entity can have the following states. Each item shows the label you see in the Home Assistant interface, followed by the state as Home Assistant stores it. If you write templates or edit automations in YAML, use the stored state.
-
On (
on): The humidifier is turned on. -
Off (
off): The humidifier is turned off.
In addition, the entity can have the following states:
-
Unavailable (
unavailable): The entity is currently unavailable. -
Unknown (
unknown): The state is not yet known.
Device class
The device class tells Home Assistant whether a device adds humidity to the air or removes it. Google Assistant and Apple Home use the device class to show the device as a humidifier or a dehumidifier.
The integration that provides the humidifier sets the device class.
Device classes in automations and templates
- Automations: The device class doesn’t change how a humidifier works in automations.
- Templates: The device class is the
device_classattribute of the entity. Use the stored value, such asdehumidifier. For example, you can find entities by device class.
List of available device classes
Without a device class, Home Assistant treats the device as a humidifier.
Each item shows the name you see in the Home Assistant interface, followed by the device class as Home Assistant stores it.
-
Humidifier (
humidifier): Adds humidity to the air around it. -
Dehumidifier (
dehumidifier): Removes humidity from the air around it.
List of triggers
The Humidifier integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following triggers. Each link below opens a dedicated page with examples, fields, and a step-by-step UI walkthrough.
-
Humidifier mode changed (
humidifier.mode_changed) Triggers when the mode of one or more humidifiers changes. -
Humidifier started drying (
humidifier.started_drying) Triggers when one or more humidifiers start drying. -
Humidifier started humidifying (
humidifier.started_humidifying) Triggers when one or more humidifiers start humidifying. -
Humidifier turned off (
humidifier.turned_off) Triggers when one or more humidifiers turn off. -
Humidifier turned on (
humidifier.turned_on) Triggers when one or more humidifiers turn on.
For an overview of every trigger across all integrations, see the triggers reference.
List of conditions
The Humidifier integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following conditions. Each link below opens a dedicated page with examples, fields, and a step-by-step UI walkthrough.
-
Humidifier is drying (
humidifier.is_drying) Tests if one or more humidifiers are drying. -
Humidifier is humidifying (
humidifier.is_humidifying) Tests if one or more humidifiers are humidifying. -
Humidifier is in mode (
humidifier.is_mode) Tests if one or more humidifiers are set to a specific mode. -
Humidifier is off (
humidifier.is_off) Tests if one or more humidifiers are off. -
Humidifier is on (
humidifier.is_on) Tests if one or more humidifiers are on. -
Humidifier target humidity (
humidifier.is_target_humidity) Tests the target humidity of one or more humidifiers.
For an overview of every condition across all integrations, see the conditions reference.
List of actions
The Humidifier 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.
-
Set humidifier target humidity (
humidifier.set_humidity) Sets the target humidity of a humidifier. -
Set humidifier mode (
humidifier.set_mode) Sets the mode of a humidifier. -
Toggle humidifier (
humidifier.toggle) Toggles a humidifier on or off. -
Turn off humidifier (
humidifier.turn_off) Turns off a humidifier. -
Turn on humidifier (
humidifier.turn_on) Turns on a humidifier.
For an overview of every action across all integrations, see the actions reference.