Cover

Home Assistant can give you an interface to control covers such as roller shutters, blinds, and garage doors.

The state of a cover

A cover can have the following states:

• Opening: The cover is in the process of opening to reach a set position.
• Open: The cover has reached the open position.
• Closing: The cover is in the process of closing to reach a set position.
• Closed: The cover has reached the closed position.
• Unavailable: The entity is currently unavailable.
• Unknown: The state is not yet known.

How the state of a cover is represented in the frontend depends on the device class.

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 icons representing different device classes for covers:

List of cover examples.

Example of various device classes icons in open and closed state. The open image in this example has state_color: true specified in the Entities card configuration to receive the icon coloring.

The following device classes are supported for covers.

• None: Generic cover. This is the default and doesn’t need to be set.
• awning: Control of an awning, such as an exterior retractable window, door, or patio cover.
• blind: Control of blinds, which are linked slats that expand or collapse to cover an opening or may be tilted to partially covering an opening, such as window blinds.
• curtain: Control of curtains or drapes, which is often fabric hung above a window or door that can be drawn open.
• damper: Control of a mechanical damper that reduces airflow, sound, or light.
• door: Control of a door or gate that provides access to an area.
• garage: Control of a garage door that provides access to a garage.
• gate: Control of a gate. Gates are found outside of a structure and are typically part of a fence.
• shade: Control of shades, which are a continuous plane of material or connected cells that expanded or collapsed over an opening, such as window shades.
• shutter: Control of shutters. Shutters are linked slats that can be raised or lowered to cover an opening, such as window or door roller shutters. Some shutters, for example, some indoor or exterior window shutters, swing out or in to cover an opening or may be tilted to provide partial cover.
• window: Control of a physical window that opens and closes or may tilt.

List of triggers

The Cover 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.

• Awning closed (cover.awning_closed) Triggers after one or more awnings close.

• Awning opened (cover.awning_opened) Triggers after one or more awnings open.

• Blind closed (cover.blind_closed) Triggers after one or more blinds close.

• Blind opened (cover.blind_opened) Triggers after one or more blinds open.

• Curtain closed (cover.curtain_closed) Triggers after one or more curtains close.

• Curtain opened (cover.curtain_opened) Triggers after one or more curtains open.

• Shade closed (cover.shade_closed) Triggers after one or more shades close.

• Shade opened (cover.shade_opened) Triggers after one or more shades open.

• Shutter closed (cover.shutter_closed) Triggers after one or more shutters close.

• Shutter opened (cover.shutter_opened) Triggers after one or more shutters open.

For an overview of every trigger across all integrations, see the triggers reference.

List of conditions

The Cover 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.

• Awning is closed (cover.awning_is_closed) Tests if one or more awnings are closed.

• Awning is open (cover.awning_is_open) Tests if one or more awnings are open.

• Blind is closed (cover.blind_is_closed) Tests if one or more blinds are closed.

• Blind is open (cover.blind_is_open) Tests if one or more blinds are open.

• Curtain is closed (cover.curtain_is_closed) Tests if one or more curtains are closed.

• Curtain is open (cover.curtain_is_open) Tests if one or more curtains are open.

• Shade is closed (cover.shade_is_closed) Tests if one or more shades are closed.

• Shade is open (cover.shade_is_open) Tests if one or more shades are open.

• Shutter is closed (cover.shutter_is_closed) Tests if one or more shutters are closed.

• Shutter is open (cover.shutter_is_open) Tests if one or more shutters are open.

For an overview of every condition across all integrations, see the conditions reference.

Actions

Cover control actions

Available actions: cover.open_cover, cover.close_cover, cover.stop_cover, cover.toggle, cover.open_cover_tilt, cover.close_cover_tilt, cover.stop_cover_tilt, cover.toggle_tilt

Automation example

automation:
  triggers:
    - trigger: time
      at: "07:15:00"
  actions:
    - action: cover.open_cover
      target:
        entity_id: cover.demo

Action: Set cover position

The cover.set_cover_position action allows you to set cover position of one or multiple covers.

Automation example

automation:
  triggers:
    - trigger: time
      at: "07:15:00"
  actions:
    - action: cover.set_cover_position
      target:
        entity_id: cover.demo
      data:
        position: 50

Action: Set cover tilt position

The cover.set_cover_tilt_position action allows you to set cover tilt position of one or multiple covers.

Automation example

automation:
  triggers:
    - trigger: time
      at: "07:15:00"
  actions:
    - action: cover.set_cover_tilt_position
      target:
        entity_id: cover.demo
      data:
        tilt_position: 50

Cover automation examples

You can use cover triggers and conditions to adjust lighting, remind yourself when something is still open, and run routines that depend on whether a cover is open or closed.

Automation: turn off the office lamp when the blind opens after sunrise

If daylight is enough for the room, this automation turns off the office lamp when the blind opens in the morning.

• Trigger: Blind opened
  • Target: Office blind
• Action: Turn off light
  • Target: Office lamp

alias: "Turn off the office lamp when the blind opens"
triggers:
  - trigger: cover.blind_opened
    target:
      entity_id: cover.office_blind
conditions:
  - condition: sun
    after: sunrise
actions:
  - action: light.turn_off
    target:
      entity_id: light.office_lamp

Automation: close the bedroom shutter at sunset if it is still open

At sunset, this automation checks whether the bedroom shutter is still open. If it is, Home Assistant closes it for the night.

• Trigger: Sun: Sunset
• Condition: Shutter is open
  • Target: Bedroom shutter
• Action: Close cover

alias: "Close the bedroom shutter at sunset"
triggers:
  - trigger: sun
    event: sunset
conditions:
  - condition: cover.shutter_is_open
    target:
      entity_id: cover.bedroom_shutter
actions:
  - action: cover.close_cover
    target:
      entity_id: cover.bedroom_shutter

Known limitations

The triggers and conditions documented on this page work only with cover entities that use the awning, blind, curtain, shade, or shutter device class.