Skip to content

πŸ‘€ Material Sensor Dialog ​

NOTE

πŸ†• Introduced in version 2.0.0
✨ Available on Free and Paid mode

✨ Overview ​

The Material Dialog is a new interactive component that allows you to view detailed information about a sensor device in a modern Material Design popup.
It provides contextual data, related entities, and device information, all inside a responsive dialog optimized for both desktop and mobile (with full-screen mode on phones).

This dialog gives users a fast and elegant way to check sensor states such as temperature, humidity, motion, or door status without leaving the main Lovelace dashboard.

β˜€οΈ Light Mode

Dialog Light
πŸŒ™ Dark Mode

Dialog Dark

βœ… How to Open the Material Dialog ​

πŸ†“ Free Version ​

To open the Material Dialog, simply use the material-button-card with the attribute:

yaml
use_default_toggle: true

When the button is configured with one of the supported sensor types, tapping it will automatically open the Material Dialog with detailed information.

Example Configuration

yaml
type: custom:material-button-card
control_type: generic
entity: binary_sensor.motion_livingroom
use_default_icon: true
use_default_toggle: true # <-- Required in the Free version!

When the entity corresponds to a supported sensor (e.g., motion, door, temperature, humidity), the dialog will open automatically upon tap.

ℹ️ Action trigger ​

Card TypeAction TypeSensor
material-button-cardtap_actiondoor, motion, temperature

πŸͺ„ Pro & Ultimate Version ​

In the paid versions, automatic actions are the default behavior.

  • If you do not define a tap_action or the hold_action, the custom-more-info action will be executed on tap.
  • You do not need to use use_default_toggle, which is deprecated in these versions.

Example (Pro/Ultimate): more-info is automatic

yaml
type: custom:material-button-card
control_type: generic
entity: binary_sensor.motion_livingroom
use_default_icon: true

ℹ️ Action trigger ​

Action TypeCard TypeSensor (By Device Class)
tap_actionmaterial-button-card, material-options-card, material-circle-progress-carddoor, motion, temperature, presence, occupancy

NOTE

🧠 More sensor types may be added in future updates.

βš™οΈ Supported Device Classes ​

πŸ†“ Free Version ​

The Material Dialog is currently compatible with the following device types:

Device TypeDescription
motionMotion or presence sensors. Displays active/inactive state with animated feedback.
doorDoor or window contact sensors. Shows open/closed status.
temperatureTemperature sensors. Displays current temperature and related entities.
humidityHumidity sensors. Displays current humidity level and related information.

πŸͺ„ Pro & Ultimate Version ​

Device TypeDescription
motion, presence, occupancyMotion or presence sensors. Displays active/inactive state with animated feedback.
doorDoor or window contact sensors. Shows open/closed status.
temperatureTemperature sensors. Displays current temperature and related entities.
humidityHumidity sensors with progress card. Displays current humidity level and related information.

NOTE

🧠 More device classes may be added in future updates.

🎨 Dialog Features ​

FeatureDescription
Dynamic HeaderShows device name, area, and state.
Animated Status CircleVisual indicator (pulsing border) for active sensors.
Related Entities SectionLists all entities associated with the same device (e.g., battery, signal strength).
Action MenuQuick access to β€œDevice Info” and β€œRelated” pages.
History ButtonOpens Home Assistant’s built-in history panel for the entity.
Dark/Light Theme SupportAutomatically adapts to HA theme settings.
Responsive LayoutFullscreen modal on mobile devices, centered dialog on desktop.

πŸ’‘ Example Use Cases ​

  • Tap a motion sensor β†’ view detection status, last activity, and related entities.
  • Tap a temperature sensor β†’ see the current temperature, humidity, and connected devices.
  • Tap a door sensor β†’ quickly check if a window or door is open.

⚠️ Notes

  • The Material Dialog works only when use_default_toggle: true is enabled. (Only in the Free version)
  • The dialog is automatically managed, no need to specify the type manually.
  • If the entity is not one of the supported sensor types, no dialog will open.