Skip to content

Card Title

Dckiller edited this page Oct 15, 2026 · 1 revision

🏷️ Title Card (title)

A section header to split a page: Lights, Living room, Media… A title, an optional subtitle, and optionally an icon with a line. Adapted from Home Assistant's Mushroom title card.

The title and the subtitle can also be tapped, with the same actions as a scene grid tile.

📸 Preview

✨ Features & Possibilities

  • Title (large) and subtitle (smaller), aligned left, centre, right or justified.
  • Icon + divider: a small PNG icon before the title and a line filling the rest of the row, for a "Bubble Card" look. With either one, the title row stays left-aligned.
  • Colour of the title, and of the line (faded) when the divider is on.
  • Tap actions: open a page or a popup, run a scene, start an Activity, send an IR or Harmony command… Without an action, the title isn't tappable.

⚙️ Options Reference

Parameter Type Default Description
type string — title
title string — The title.
subtitle string — The subtitle.
alignment string start start, center, end or justify.
icon string — Path of an uploaded PNG icon, e.g. /sdcard/astrion/icons/sofa.png.
divider bool false Line after the title.
color string theme text Title colour, e.g. #FF7FB3C4.

Tap actions

Prefix any field with title_ (for the title) or subtitle_ (for the subtitle):

Field Does
…_entity_id Turn on a scene or script.
…_page (+ …_pageMode: "popup") Open a page, or open it as a popup.
…_closePopup Close the popup on screen.
…_activity Start a composed Activity.
…_activityId (+ …_hub) Start a Harmony activity.
…_harmonyDevice + …_harmonyCommand (+ …_hub) Send a Harmony command.
…_irDevice + …_irCommand Send an IR command.

📄 JSON Configuration Example

[
  { "type": "title", "options": { "title": "Living room", "subtitle": "Lights and blinds",
                                  "icon": "/sdcard/astrion/icons/sofa.png", "divider": true, "color": "#FF7FB3C4",
                                  "title_page": "Living room lights" } },
  { "type": "title", "options": { "title": "Doorbell", "alignment": "center",
                                  "subtitle": "Tap to open the camera",
                                  "subtitle_page": "Camera", "subtitle_pageMode": "popup" } }
]

See also: Card Scene grid · Builder

Clone this wiki locally