Status Card

Status Card

Status Card shows entity state in a visual summary card.

type: custom:orbit-status-card

Modes

Mode	Use for
standard	Wide status summary card with name, icon, and status text.
icon_only	Compact square icon card with optional numeric badge.
person	Person card with picture, tracker status, zone badge, ETA, and battery badges.

Standard Mode

type: custom:orbit-status-card
mode: standard
main_entity: sensor.heating_state
status_name: Heating
accent_on_color: red
accent_off_color: theme
tap_action:
  action: navigate
  navigation_path: /dashboard-heating/heating-control
main_entity_tap_action:
  action: more-info

Standard mode uses:

1. status_name when set
2. Otherwise the entity friendly name
3. label_template when set for the displayed status
4. Otherwise the entity label attribute when available
5. Otherwise the formatted entity state

Colour priority:

1. accent_on_color / accent_off_color
2. Entity color attribute
3. Theme fallback

Icon Only Mode

type: custom:orbit-status-card
mode: icon_only
main_entity: sensor.number_of_lights_on
accent_on_color: amber
accent_off_color: theme
tap_action:
  action: more-info

Icon only mode shows a compact square card. The badge is hidden when the displayed label is numeric 0.

Icon Only Group

Use entities to place multiple Icon only items inside one Orbit Status Card.

type: custom:orbit-status-card
mode: icon_only
wrap: true
items_per_row: 3
separate_cards: false
entities:
  - entity: sensor.number_of_lights_on
    accent_on_color: amber
    main_entity_icon: mdi:lightbulb-group
    main_entity_tap_action:
      action: popup
      popup_title: Lights
      popup_content:
        type: tile
        entity: light.living_room

  - entity: sensor.number_of_doors_open
    accent_on_color: blue
    main_entity_icon: mdi:door-open

  - entity: sensor.unavailable_entities
    accent_on_color: red
    main_entity_icon: mdi:alert-circle-outline

Use separate_cards: true when you want each item to read as its own small card:

type: custom:orbit-status-card
mode: icon_only
wrap: true
items_per_row: 3
separate_cards: true
entities:
  - entity: sensor.recycle_collection
    accent_on_color: blue
    label_template: state_attr('sensor.recycle_collection', 'daysTo')
    state_template: state_attr('sensor.recycle_collection', 'daysTo') | int < 2
  - entity: sensor.rubbish_collection
    accent_on_color: green
    label_template: state_attr('sensor.rubbish_collection', 'daysTo')
    state_template: state_attr('sensor.rubbish_collection', 'daysTo') | int < 2

Person Mode

type: custom:orbit-status-card
mode: person
main_entity: person.andrew
tracker_entity: device_tracker.andrew_phone
eta_entity: sensor.andrew_eta
battery_entity_1: sensor.andrew_phone_battery
battery_entity_2: sensor.andrew_watch_battery
tap_action:
  action: more-info
main_entity_tap_action:
  action: none

Person mode uses:

• main_entity as the person entity
• Person entity picture as the main image
• Entity icon fallback when no picture is available
• tracker_entity for location/status
• eta_entity appended when the tracker is not home
• A zone badge based on the active Home Assistant zone
• Up to two battery badges

Battery badge taps always open more-info for the battery entity.

Templates

state_template controls ON/OFF detection.

label_template controls the displayed text or badge value.

type: custom:orbit-status-card
mode: icon_only
main_entity: sensor.recycle_collection
state_template: state_attr('sensor.recycle_collection', 'daysTo') | int < 2
label_template: state_attr('sensor.recycle_collection', 'daysTo')
accent_on_color: green
accent_off_color: theme

For Icon only mode, numeric 0 is OFF and values greater than 0 are ON unless state_template overrides detection.

Common safe/normal states are treated as OFF, including:

• off
• disarmed
• closed
• locked
• clear
• normal
• home
• online
• connected

Interactions

Status Card supports:

tap_action:
  action: more-info

hold_action:
  action: none

double_tap_action:
  action: none

Icon/main entity actions:

main_entity_tap_action:
  action: more-info

main_entity_hold_action:
  action: none

main_entity_double_tap_action:
  action: none

Grouped entities items support the same action keys inside each item.

Options

Option	Description
mode	standard, icon_only, or person. Defaults to standard.
main_entity	Required. Standard/Icon only use it as the status entity. Person mode uses it as the person entity.
entities	Icon only mode only. Optional grouped status item list.
wrap	Icon only group only. Allows grouped items to wrap onto additional rows.
items_per_row	Icon only group only. Number of items per row when wrapping. Defaults to 3.
separate_cards	Icon only group only. Adds spacing and individual card backgrounds.
status_name	Optional plain text or composed card name.
tracker_entity	Person mode only. Tracker used for location/status.
eta_entity	Person mode only. Optional ETA entity.
battery_entity_1	Person mode only. First battery badge.
battery_entity_2	Person mode only. Second battery badge.
state_template	Standard/Icon only. Template for ON/OFF detection.
label_template	Standard/Icon only. Template for displayed text/badge.
accent_on_color	ON colour override.
accent_off_color	OFF colour override.
main_entity_icon_source	entity or custom.
main_entity_icon	Icon override.
main_entity_icon_on	Icon used when ON.
main_entity_icon_off	Icon used when OFF.
tap_action	Card tap action.
hold_action	Card hold action.
double_tap_action	Card double tap action.
main_entity_tap_action	Main icon/entity tap action.
main_entity_hold_action	Main icon/entity hold action.
main_entity_double_tap_action	Main icon/entity double tap action.

Picker Filters

The Status Card editor includes quick filters for main entity pickers:

• All
• Binary Sensors
• Sensors

All keeps the picker unrestricted.