19 KiB
title, description, related
title | description | related | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Features for dashboard cards | Decorate your dashboard cards with quick controls. |
|
Some dashboard cards have support for features. These widgets add quick controls to the card. Supported features depend on the card and entity capabilities. Multiple features can be added to a single card.
Screenshot of tile cards with features.
Features can be enabled on the following cards:
Customizing features
-
Edit the card and open the Features section.
-
To add an additional feature to your card, select Add feature.
- Info: The available options for a feature depend on the entity and type of feature.
- For example, not all entities have a toggle or a counter-action.
- Info: The available options for a feature depend on the entity and type of feature.
-
On tile cards, you can adjust the feature position.
- Under Features > Feature position, select Bottom or Inline:
-
Reordering features:
- Some features of the tile card, such as the presets or the HVAC modes of a thermostat, can show buttons.
- To reorder the buttons, enable Customize and drag and drop the buttons into position.
- If you don't like the buttons, you can replace them by a Dropdown instead.
- Under Style, select the Dropdown option.
Alarm modes
Widget that displays buttons to arm and disarm an alarm.
Screenshot of the tile card with alarm modes feature
features:
- type: "alarm-modes"
modes:
- armed_home
- armed_away
- armed_night
- armed_vacation
- armed_custom_bypass
- disarmed
{% configuration features %}
type:
required: true
description: "alarm-modes
"
type: string
modes:
required: true
description: List of modes to show on the card. The list can contain armed_home
, armed_away
, armed_night
, armed_vacation
, armed_custom_bypass
, and disarmed
.
type: list
{% endconfiguration %}
Climate fan modes
Widget that displays buttons or icons to control the fan mode for a climate device.
Screenshot of the tile card with the climate fan modes feature
features:
- type: "climate-fan-modes"
style: "icons"
fan_modes:
- "off"
- low
- medium
- high
{% configuration features %}
type:
required: true
description: "climate-fan-modes
"
type: string
style:
required: false
description: "How the fan modes should be displayed. It can be either dropdown
or icons
."
type: string
default: dropdown
fan_modes:
required: true
description: List of fan modes to show on the card. The list can contain on
, off
, auto
, low
, medium
, high
, middle
, focus
and diffuse
or any other custom fan mode.
type: list
{% endconfiguration %}
Climate HVAC modes
Widget that displays buttons to control the HVAC mode for a climate.
Screenshot of the tile card with the climate HVAC modes feature
features:
- type: "climate-hvac-modes"
hvac_modes:
- auto
- heat_cool
- heat
- cool
- dry
- fan_only
- "off"
{% configuration features %}
type:
required: true
description: "climate-hvac-modes
"
type: string
style:
required: false
description: "How the modes should be displayed. It can be either dropdown
or icons
."
type: string
default: icons
hvac_modes:
required: true
description: List of modes to show on the card. The list can contain auto
, heat_cool
, heat
, cool
, dry
, fan_only
, and off
.
type: list
{% endconfiguration %}
Climate preset modes
Widget that displays buttons or icons to control the preset mode for a climate.
Screenshot of the tile card with the climate preset modes feature
features:
- type: "climate-preset-modes"
style: "icons"
preset_modes:
- home
- eco
{% configuration features %}
type:
required: true
description: "climate-preset-modes
"
type: string
style:
required: false
description: "How the preset modes should be displayed. It can be either dropdown
or icons
."
type: string
default: dropdown
preset_modes:
required: true
description: List of preset modes to show on the card. The list can contain eco
, away
, boost
, comfort
, home
, sleep
, and activity
or any other custom preset mode.
type: list
{% endconfiguration %}
Counter actions
Widget that displays buttons to increment, decrement, and reset a counter.
Screenshot of the tile card with counter actions feature
features:
- type: "counter-actions"
actions:
- increment
- decrement
- reset
{% configuration features %}
type:
required: true
description: "counter-actions
"
type: string
actions:
required: true
description: List of actions to show on the card. The list can contain increment
, decrement
, and reset
.
type: list
{% endconfiguration %}
Cover open/close
Widget that displays buttons to open, close, or stop a cover.
Screenshot of the tile card with cover open/close feature
features:
- type: "cover-open-close"
{% configuration features %}
type:
required: true
description: "cover-open-close
"
type: string
{% endconfiguration %}
Cover position
Widget that displays a slider to control the position for a cover.
Screenshot of the tile card with the cover position feature
features:
- type: "cover-position"
{% configuration features %}
type:
required: true
description: "cover-position
"
type: string
{% endconfiguration %}
Cover tilt
Widget that displays buttons to open, close, or stop a cover.
Screenshot of the tile card with cover tilt feature
features:
- type: "cover-tilt"
{% configuration features %}
type:
required: true
description: "cover-tilt
"
type: string
{% endconfiguration %}
Cover tilt position
Widget that displays a slider to control the tilt position for a cover.
Screenshot of the tile card with the cover tilt position feature
features:
- type: "cover-tilt-position"
{% configuration features %}
type:
required: true
description: "cover-tilt-position
"
type: string
{% endconfiguration %}
Fan preset modes
Widget that displays buttons or icons to control the preset mode for a fan.
Screenshot of the tile card with the fan preset modes feature
features:
- type: "fan-preset-modes"
style: "icons"
preset_modes:
- auto
- smart
- sleep
- 'on'
{% configuration features %}
type:
required: true
description: "fan-preset-modes
"
type: string
style:
required: false
description: "How the preset modes should be displayed. It can be either dropdown
or icons
."
type: string
default: dropdown
preset_modes:
required: true
description: List of preset modes to show on the card. The list can contain any supported preset modes.
type: list
{% endconfiguration %}
Fan speed
Widget that displays speed controls for a fan.
Screenshot of the tile card with fan speed feature
features:
- type: "fan-speed"
{% configuration features %}
type:
required: true
description: "fan-speed
"
type: string
{% endconfiguration %}
Humidifier modes
Widget that displays buttons or icons to control the mode for a humidifier.
Screenshot of the tile card with the humidifier modes feature
features:
- type: "humidifier-modes"
style: "icons"
modes:
- home
- eco
{% configuration features %}
type:
required: true
description: "humidifier-modes
"
type: string
style:
required: false
description: "How the modes should be displayed. It can be either dropdown
or icons
."
type: string
default: dropdown
modes:
required: true
description: List of modes to show on the card. The list can contain normal
, eco
, away
, boost
, comfort
, home
, sleep
, auto
, and baby
or any other custom mode.
type: list
{% endconfiguration %}
Humidifier toggle
Widget that displays buttons to turn on or off a humidifier.
Screenshot of the tile card with the humidifier toggle feature
features:
- type: "humidifier-toggle"
{% configuration features %}
type:
required: true
description: "humidifier-toggle
"
type: string
{% endconfiguration %}
Lawn mower commands
Widget that displays buttons to control a lawn mower.
Screenshot of the tile card with the lawn mower commands feature
features:
- type: "lawn-mower-commands"
commands:
- start_pause
- dock
{% configuration features %}
type:
required: true
description: "lawn-mower-commands
"
type: string
commands:
required: true
description: List of commands to show on the card. The list can contain start_pause
and dock
.
type: list
{% endconfiguration %}
Light brightness
Widget that displays a slider to select the brightness for a light.
Screenshot of the tile card with light brightness feature
features:
- type: "light-brightness"
{% configuration features %}
type:
required: true
description: "light-brightness
"
type: string
{% endconfiguration %}
Light color temp
Widget that displays a slider to select the color temperature for a light.
Screenshot of the tile card with the light color temperature feature
features:
- type: "light-color-temp"
{% configuration features %}
type:
required: true
description: "light-color-temp
"
type: string
{% endconfiguration %}
Lock commands
Widget that displays buttons to lock or unlock a lock.
Screenshot of the tile card with the lock commands feature
features:
- type: "lock-commands"
{% configuration features %}
type:
required: true
description: "lock-commands
"
type: string
{% endconfiguration %}
Lock open door
Widget that displays a button to open a door.
Screenshot of the tile card with the lock open door feature
features:
- type: "lock-open-door"
{% configuration features %}
type:
required: true
description: "lock-open-door
"
type: string
{% endconfiguration %}
Media player volume slider
Widget that displays a slider to control the volume for a media player.
Screenshot of the tile card with media player volume slider feature
features:
- type: "media-player-volume-slider"
{% configuration features %}
type:
required: true
description: "media-player-volume-slider
"
type: string
{% endconfiguration %}
Numeric input
Widget that displays a slider or buttons to set the value for a number or input number.
Screenshot of the tile card with the numeric input feature
features:
- type: "numeric-input"
style: "buttons"
{% configuration features %}
type:
required: true
description: "numeric-input
"
type: string
style:
required: false
description: "Which style of control to display. It can be either buttons
or slider
."
type: string
default: slider
{% endconfiguration %}
Target humidity
Widget that displays a slider to select the target humidity for a humidifier.
Screenshot of the tile card with the target humidity feature
features:
- type: "target-humidity"
{% configuration features %}
type:
required: true
description: "target-humidity
"
type: string
{% endconfiguration %}
Target temperature
Widget that displays buttons to select the target temperature for a climate or a water heater.
Screenshot of the tile card with the target temperature feature
features:
- type: "target-temperature"
{% configuration features %}
type:
required: true
description: "target-temperature
"
type: string
{% endconfiguration %}
Toggle
Widget that displays a button to toggle a switch or input boolean entity on or off.
Screenshot of the tile card with the toggle feature
features:
- type: "toggle"
{% configuration features %}
type:
required: true
description: "toggle
"
type: string
{% endconfiguration %}
Update actions
Widget that displays actions to install or skip an update.
Screenshot of the tile card with update actions feature
features:
- type: "update-actions"
backup: "ask"
{% configuration features %}
type:
required: true
description: "update-actions
"
type: string
backup:
required: false
description: Whether a backup should be done before updating. The value can be ask
, yes
, or no
. ask
will open a dialog to ask if a backup should be done.
type: list
default: ask
{% endconfiguration %}
Vacuum commands
Widget that displays buttons to control a vacuum.
Screenshot of the tile card with vacuum commands feature
features:
- type: "vacuum-commands"
commands:
- start_pause
- stop
- clean_spot
- locate
- return_home
{% configuration features %}
type:
required: true
description: "vacuum-commands
"
type: string
commands:
required: true
description: List of commands to show on the card. The list can contain start_pause
, stop
, clean_spot
, locate
, and return_home
.
type: list
{% endconfiguration %}
Water heater operation modes
Widget that displays buttons to control the operation mode of a water heater.
Screenshot of the tile card with the water heater operation modes feature
features:
- type: "water-heater-operation-modes"
operation_modes:
- electric
- gas
- heat_pump
- eco
- performance
- high_demand
- "off"
{% configuration features %}
type:
required: true
description: "water-heater-operation-modes
"
type: string
operation_modes:
required: true
description: List of modes to show on the card. The list can contain electric
, gas
, heat_pump
, eco
, performance
, high_demand
, and off
.
type: list
{% endconfiguration %}