Skip to content

💬 Material Dialog Card

NOTE

Available on 💎 Ultimate Version Only

✨ Overview

The Material Dialog Card brings native-like dialog interactions to your dashboard. Designed to display detailed information or controls without leaving the current view, it supports a wide range of content cards and seamless hash-based navigation.

☀️ Light Mode

Control Light
🌙 Dark Mode

Control Dark

✨ Key Features

  • Hash Navigation: Opens effortlessly using URL hashes (e.g., #dialog), making it easy to link from other cards.
  • Adaptive Layout: Automatically adjusts between a centered dialog and a full-screen view based on device size.
  • Rich Header: Includes customizable titles, icons, area indicators, and action buttons.
  • Dropdown Menus: Supports overflow menus in the header for secondary actions.
  • Flexible Content: Can host any combination of Lovelace cards inside the dialog body.

⚙️ Configuration

NameTypeDefaultDescription
typestringRequiredcustom:material-dialog-card
hashstring#dialogThe URL hash that triggers this dialog to open.
cardslist[]A list of cards to display inside the dialog body.
headerobjectOptionalConfiguration for the dialog header.
settingsobjectOptionalAdditional behavior settings.

Header Options (header)

NameTypeDefaultDescription
namestringEntity NameTitle text displayed in the header.
entitystringOptionalEntity used to derive name and state.
button_typestringnameControls header display: state or name.
show_areabooleantrueDisplays the area associated with the entity.
sub_buttonslist[]List of icon buttons displayed in the header.
dropdown_buttonslist[]List of items for the overflow dropdown menu.

Settings Options (settings)

NameTypeDefaultDescription
show_old_dialogbooleanfalseForces the use of the legacy ha-dialog instead of ha-adaptive-dialog.

🚀 Usage Examples

Example Configuration:

yaml
type: custom:material-dialog-card
hash: "#living-room-climate"
header:
  entity: climate.living_room
  name: Living Room Climate
  show_area: true
  sub_buttons:
    - icon: mdi:cog
      tap_action:
        action: navigate
        navigation_path: /config/integrations
cards:
  - type: thermostat
    entity: climate.living_room
  - type: entities
    entities:
      - entity: sensor.living_room_humidity
      - entity: sensor.living_room_temperature