Dashboard cards
Each dashboard is made up of cards. Cards display information and let you control your devices. You can arrange them freely across views, resize them in the Sections view layout, and configure actions, features, and conditional visibility.
Screenshot of the masonry view with different types of cards.
Card categories
There are several different card types, each with their own configuration options. They can be categorized in terms of their function:
- Specific to a device type or service: alarm, light, humidifier, thermostat, plant status, media control, weather forecast, to-do list, shopping list, map, activity, calendar
- Grouping other cards: vertical stack, horizontal stack, grid
- Logic function: conditional, entity filter
- Display generic data: sensor, history graph, statistic, statistics graph, energy, gauge, clock, Markdown, webpage
- Control devices and entities: button, entity, shortcut
- Display data and control entities: tile, alert, heading, entities, glance, area, picture, picture entity, picture elements, picture glance
Adding cards to your dashboard
A card can be added to a dashboard directly from the view where you want to have it.
- Go to Settings > Dashboards.
- Select your dashboard from the list.
- If your dashboard has multiple views, select the view to which you want to add a card.
- In the top right of the screen, select the edit
button. - Depending on your dashboard view layout:
- For Sections layout, select
in the section (bottom left).
- For other layout types (such as Masonry, Panel, or Sidebar), in the bottom right of the view, select Add card.
- For Sections layout, select
- There are three methods to add a card:
-
By entity.
- Select the entities from the list.
- Then, select the card you want from the preview.
- If you can’t see your entity, check the Unassigned section. Entities that are not assigned to an area are listed there.
-
By card:
- Browse the list of available cards.
- If you are using the Sections view, try the Tile card in the Suggested cards section.
- From a copied card: If you copied a card, Paste card is shown at the bottom left of the dialog. Select it to add the card. The same works for badges when you add a badge.
-
By entity.
- If you want this card to be visible only to specific users or under a certain condition, you can define those conditions.
- If you are adding this card to a sections view, on the Layout tab, you can resize the card.
- Customize your card:
- define card actions.
- define header and footer
- customize features.
- Not all cards support these elements. Refer to the documentation of the specific card type.
- In the top right of the screen, select Done to save the changes of the view.
Adding a device to your dashboard
This method is useful, for example, if you are on the page of a device and want to add all its entities to a dashboard in one step, instead of adding them card by card.
- Go to Settings > Devices & services.
- On the integration card of interest, select Devices or select the Devices tab.
- If there are multiple devices, select the device from the list.
- Next to Related, select Add to… and then Add to a dashboard.
- Select the dashboard, the view, and then select Next.
- Set the options in the Device section configuration dialog and select Save, or select Add to dashboard, depending on the type of the selected view.
- In a sections view, a Device section for this device is added. It stays up to date when the device gets new entities.
- In other views, an Entities card is added.
Showing or hiding a card or badge conditionally
You can choose to show or hide certain cards or badges based on different conditions. You can use conditions about the person viewing the dashboard and their device, such as User, Screen, Location, and Time. You can also use the same conditions as in automations, such as Entity state, Template, Sun, Zone, and Device. The available conditions are the same as the ones for the conditional card.
- On the Visibility tab, select Add condition.
- Troubleshooting: Don’t see a Visibility tab?
- It is not available inside nested cards: vertical stack, horizontal stack, and grid card
- Troubleshooting: Don’t see a Visibility tab?
- Select the type of condition, and enter the parameters.
- If you define multiple conditions, the card or badge is only shown when all conditions are met.
- If you did not define any conditions, the card or badge is always shown to all users.
- To change the order of the conditions, drag a condition by its handle
. - Check the result before you save.
- At the top of the tab, Current visibility shows whether the card or badge would be shown right now.
- Each condition shows whether it passes right now, for example Condition passes or Condition did not pass.
- Select Save.
Resizing a card
In sections view, you can resize cards. Each card has a recommended size, which it keeps until you change it. Follow these steps:
-
On the Layout tab, turn off Use recommended size. Below the switch, you can see the recommended size of the card, for example 6 columns × 2 rows.

- Troubleshooting: Don’t see a Layout tab?
- It is not available inside nested cards: vertical stack, horizontal stack, and grid card
- It is not available on the picture elements card.
- Troubleshooting: Don’t see a Layout tab?
-
Use the grid size picker to adjust the number of columns and rows the card occupies.
-
If you want to set the width with more precision, select Enter precise mode (
) in the upper-left corner of the grid. To leave precise mode, select the button again. In the example below, all cards were resized using precise mode. 
-
To make the card as tall as its content, enable Fit height to content.
-
To make the card always fill the section, whatever its width, enable Full width.
-
Select Save.
Revert resizing of a card
If you previously resized a card in the sections view, and you don’t like the new size, you can go back to the recommended size of the card. Follow these steps:
- On the Layout tab, turn on Use recommended size.
- Select Save.
Card actions, features, header and footer widgets
Some cards have support for tap actions. These actions define what will happen when you tap or hold on an object within a card.
Some 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.
Some cards have support for header and footer widgets. These widgets fill up the entire available space in a card.
Screenshot of an entities card with a picture header and buttons footer.