home-assistant.io/source/_components/water_heater.markdown

layout, title, description, date, sidebar, comments, sharing, footer, ha_release

layout	title	description	date	sidebar	comments	sharing	footer	ha_release
page	Water Heater	Instructions on how to setup water heater devices within Home Assistant.	2018-10-10 19:00	true	false	true	true	0.81

The water_heater component is built for the controlling and monitoring of hot water heaters.

To enable this component, pick one of the platforms, and add it to your configuration.yaml:

# Example configuration.yaml entry
water_heater:
  platform: demo

{% linkable_title Services %}

{% linkable_title Water heater control services %}

Available services: water_heater.set_temperature, water_heater.turn_away_mode_on, water_heater.turn_away_mode_off, water_heater.set_operation_mode

Not all water heater services may be available for your platform. Be sure to check the available services Home Assistant has enabled by checking **Services**.

{% linkable_title Service water_heater.set_temperature %}

Sets target temperature of water heater device.

Service data attribute	Optional	Description
entity_id	yes	String or list of strings that point at entity_id's of water heater devices to control. Else targets all.
temperature	no	New target temperature for water heater
operation_mode	yes	Operation mode to set the temperature to. This defaults to current_operation mode if not set, or set incorrectly.

{% linkable_title Automation example %}

automation:
  trigger:
    platform: time
    at: "07:15:00"
  action:
    - service: water_heater.set_temperature
      data:
        entity_id: water_heater.demo
        temperature: 24
        operation_mode: eco

{% linkable_title Service water_heater.set_operation_mode %}

Set operation mode for water heater device

Service data attribute	Optional	Description
entity_id	yes	String or list of strings that point at entity_id's of water heater devices to control. Else targets all.
operation_mode	no	New value of operation mode

{% linkable_title Automation example %}

automation:
  trigger:
    platform: time
    at: "07:15:00"
  action:
    - service: water_heater.set_operation_mode
      data:
        entity_id: water_heater.demo
        operation_mode: eco

{% linkable_title Service water_heater.set_away_mode %}

Turn away mode on or off for water heater device

Service data attribute	Optional	Description
entity_id	yes	String or list of strings that point at entity_id's of water heater devices to control. Else targets all.
away_mode	no	New value of away mode. 'on'/'off' or True/False

{% linkable_title Automation example %}

automation:
  trigger:
    platform: time
    at: "07:15:00"
  action:
    - service: water_heater.set_away_mode
      data:
        entity_id: water_heater.demo
        away_mode: true