Action Card

Action Card

Action Card is a compact square card for activating scenes, scripts, automations, buttons, input buttons, input booleans, cameras, and other action-like entities.

type: custom:orbit-action-card

Basic Example

type: custom:orbit-action-card
main_entity: scene.movie_time
accent_color: blue

Default Tap Actions

Default tap actions are selected from the entity domain.

Domain	Default tap action
scene	scene.turn_on
script	script.turn_on
automation	automation.trigger
button	button.press
input_button	input_button.press
input_boolean	toggle
Other toggle-capable domains	toggle
Other domains	toggle / fallback action

Hold action defaults to more-info.

Double tap action defaults to none.

Grouped Action Card

type: custom:orbit-action-card
wrap: true
actions_per_row: 3
separate_cards: true
entities:
  - entity: scene.movie_time
    accent_color: blue
    main_entity_icon: mdi:movie-open
  - entity: script.good_night
    accent_color: purple
    main_entity_icon: mdi:weather-night
  - entity: automation.motion_lights
    accent_color: amber
    main_entity_icon: mdi:motion-sensor

Use separate_cards: true to add a small gap and make each grouped action read as its own card.

Interactions

tap_action:
  action: call-service
  service: scene.turn_on
  service_data:
    entity_id: scene.movie_time

hold_action:
  action: more-info

double_tap_action:
  action: none

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

type: custom:orbit-action-card
wrap: true
actions_per_row: 3
entities:
  - entity: scene.movie_time
    tap_action:
      action: call-service
      service: scene.turn_on
      service_data:
        entity_id: scene.movie_time
    hold_action:
      action: more-info
    double_tap_action:
      action: none

Icon Source

main_entity_icon_source: entity

Options:

• entity uses the entity/domain icon.
• custom uses main_entity_icon.

main_entity_icon_source: custom
main_entity_icon: mdi:movie-open

For multi-colour SVGs:

main_entity_icon_svg_color_override: false

Options

Option	Description
main_entity	Required for a single Action Card. Entity to activate.
entities	Optional grouped action item list. Each item supports entity, colour, icon, and action options.
wrap	Grouped mode only. Allows actions to wrap onto additional rows.
actions_per_row	Grouped mode only. Number of actions per row. Defaults to 3.
separate_cards	Grouped mode only. Adds spacing and individual item backgrounds.
accent_color	Base card/icon colour. Defaults to theme.
main_entity_icon_source	entity or custom.
main_entity_icon	Optional icon override.
main_entity_icon_svg_color_override	YAML-only SVG colour override.
tap_action	Optional tap action override. Defaults by entity domain.
hold_action	Optional hold action override. Defaults to more-info.
double_tap_action	Optional double tap action override. Defaults to none.

Picker Filters

The Action Card editor includes quick filters inside the entity picker:

• All
• Automations
• Buttons
• Cameras
• Scenes
• Scripts

All keeps the picker unrestricted.