Material Home Assistant

Appearance

🏷️ Dialog Labels Configuration ​

✨ Overview ​

Labels are powerful tools to clean up dialog interfaces or force specific behaviors when Home Assistant groups different entities under the same device. They are applied directly through the Home Assistant UI (in the "Labels" section).

🛠️ Available Labels ​

1. Dialog Hidden ​

This label is used to keep the interface clean and focused only on relevant information.

  • Usage: Apply this label to any entity (sensor, switch, etc.) that is part of a device but that you do not want to show inside the Material Dialog.
  • Example: You have a motion sensor that also exposes technical or diagnostic entities that you don't need in the daily popup.

2. Template ​

This label resolves display issues when a dialog shows unrelated entities.

  • Usage: Apply this label when the dialog refers to a Home Assistant Helper or a "template" entity.
  • Why use it: If a Home Assistant device groups many entities that have no direct logical relationship, the dialog might appear cluttered. The Template label instructs the component to handle the display in isolation, optimizing the layout for that specific entity type.

📝 How to Apply Labels ​

You can manage these labels directly in Home Assistant by following these steps:

  1. Go to Settings > Devices & Services.
  2. Select the Entities tab or navigate to the specific device.
  3. Click on the entity you wish to modify.
  4. Click the Settings (gear) icon.
  5. In the Labels field, add one of the two labels:
    • Dialog Hidden
    • Template
  6. Save the changes. The Material Dialog will update automatically on the next opening.

💡 Practical Examples ​

Use CaseLabel to UseResult
Hiding the "Battery Voltage" sensor of a remoteDialog HiddenThe dialog will only show the main buttons/state, hiding the voltage.
Configuring a sensor created via YAML or HelperTemplateThe dialog will optimize the view, avoiding showing random related entities.

⚠️ Important Note

Make sure the label text is written exactly as shown (case-sensitive), otherwise the system will not be able to recognize them correctly.