2024.11.2
Home ▸ Dashboards ▸

Tile card

The tile card gives you a quick overview of your entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more]. The card allows you to toggle the entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] and show the more info dialog. A badge is shown for some entitiesAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] like the climate or person entitiesAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more].

Screenshot of tile cards Screenshot of tile cards.

To add the tile card to your user interface:

  1. In the top right of the screen, select the edit button.
    • If this is your first time editing a dashboard, the Edit dashboard dialog appears.
      • By editing the dashboard, you are taking over control of this dashboard.
      • This means that it is no longer automatically updated when new dashboard elements become available.
      • Once you’ve taken control, you can’t get this specific dashboard back to update automatically. However, you can create a new default dashboard.
      • To continue, in the dialog, select the three dots menu, then select Take control.
  2. Add a card to your dashboard.

Configuration Variables

Looking for your configuration file?
type string Required

tile

entity string Required

Entity ID.

name string (Optional)

Overwrites the entity name.

icon string (Optional)

Overwrites the entity icon.

color string (Optional, default: state)

Set the color when the entity is active. By default, the color is based on state, domain, and device_class of your entity. It accepts color token or hex color code.

show_entity_picture boolean (Optional, default: false)

If your entity has a picture, it will replace the icon.

vertical boolean (Optional, default: false)

Displays the icon above the name and state.

hide_state boolean (Optional, default: false)

Hide the entity state.

state_content string | list (Optional)

Content to display for the state. Can be state, last_changed, last_updated, or any attribute of the entity. Can be either a string with a single item, or a list of string items. Default depends on the entity domain.

tap_action map (Optional)

Action taken on card tap. See action documentation. By default, it will show the “more-info” dialog.

hold_action map (Optional)

Action taken on tap-and-hold. See action documentation.

double_tap_action map (Optional)

Action taken on double tap. See action documentation.

icon_tap_action map (Optional)

Action taken on icon card tap. See action documentation. By default, it will toggle the entity (if possible), otherwise, show the “more-info” dialog.

icon_hold_action map (Optional)

Action taken on icon tap-and-hold. See action documentation.

icon_double_tap_action map (Optional)

Action taken on icon double tap. See action documentation.

features list (Optional)

Additional widgets to control your entity. See available features.

Examples

Alternatively, the card can be configured using YAML:

type: tile
entity: cover.kitchen_window

type: tile
entity: light.bedroom
icon: mdi:lamp
color: yellow

type: tile
entity: person.anne_therese
show_entity_picture: true

type: tile
entity: person.anne_therese
vertical: true
hide_state: true

type: tile
entity: light.living_room
state_content: 
  - state
  - brightness
  - last-changed

type: tile
entity: vacuum.ground_floor
features:
  - type: vacuum-commands
    commands:
      - start_pause
      - return_home

Available colors

You want to colorize the tile card? Choose one of the following colors: primary, accent, disabled, red, pink, purple, deep-purple, indigo, blue, light-blue, cyan, teal, green, light-green, lime, yellow, amber, orange, deep-orange, brown, grey, blue-grey, black and white.

Reordering features

Some features of the tile card, such as the presets or the HVAC modes of a thermostat, can show many buttons. While you can limit the buttons you’d like to see, they may not be in the desired order.

For your thermostat, that means you can reorder the HVAC modes or presets.

Screen recording showing how you can now reorder the HVAC modes on the thermostat shown in a tile card. You can now reorder the features of the tile card.

Related topics