Skip to content

Actions

Actions define what happens when someone taps, holds, or double-taps a tool or control.

Available actions

Action Result
more-info Opens details for the connected entity.
toggle Toggles an on/off entity.
perform-action Runs a Home Assistant action.
navigate Opens another dashboard path.
url Opens a web address.
assist Starts Home Assistant Assist.
none Disables that gesture.
Gesture Configuration
Tap tap_action
Hold hold_action
Double tap double_tap_action

Toggle an entity

1
2
tap_action:
  action: toggle

Use this on a tool connected through entity_index.

Perform a Home Assistant action

1
2
3
4
5
6
7
tap_action:
  action: perform-action
  perform_action: light.turn_on
  target:
    entity_id: light.hall
  data:
    brightness_pct: 50

1
2
3
tap_action:
  action: navigate
  navigation_path: /lovelace/lights

1
2
3
tap_action:
  action: url
  url_path: https://www.home-assistant.io/

Run actions in sequence

1
2
3
4
5
tap_action:
  actions:
    - action: toggle
    - action: navigate
      navigation_path: /lovelace/lights

Haptic feedback

1
2
3
tap_action:
  haptic: selection
  action: toggle

Haptic feedback depends on support in the Home Assistant Companion app.