Feature Subtitle

Tab subtitles

Add a small line of secondary text under a tab's label — handy for a status, count, or hint.

Per-tab key: subtitle (string)

type: custom:tabdeck-card
styles:
  --tabdeck-tab-height: 60px     # give the taller tabs a little room
tabs:
  - name: Climate
    subtitle: 3 zones
    icon: mdi:thermostat
    card: { ... }
  - name: Lights
    subtitle: 8 on
    icon: mdi:lightbulb-group
    card: { ... }
  - name: Energy
    subtitle: 1.2 kW
    icon: mdi:flash
    card: { ... }

Notes

• The subtitle sits under the label in a muted, slightly smaller font.
• It works with any display mode that shows the label (both/label); in icon-only mode the subtitle is hidden along with the label.
• Subtitles make tabs taller — bump --tabdeck-tab-height if they feel cramped.
• For a dynamic subtitle, set a template — or use a badge instead if you only need a count.
• Set it from the Subtitle field in the visual editor.