Interactive controls¶

Interactive controls add buttons, toggles, selectors, number steppers, and sliders to a card. Use them to operate an entity, change a card setting, or run a Home Assistant action where it is useful.

Use controls with Home Assistant entities when the value belongs to Home Assistant and may also be used by automations, dashboards, or other devices. Use browser-local Flexible Horseshoe Card inputs for choices that only affect Flexible Horseshoe Card cards in the current browser.

Available controls¶

Control	What it lets the user do
Button	Open details, navigate, toggle an entity, or run an action.
Number	Increase or decrease a numeric value in fixed steps.
Select	Choose one option from a visible list.
Slider	Set a numeric value or choose a lower and upper value.
Toggle	Turn an on/off entity or browser-local setting on or off.

Add a control¶

Place controls under layout.controls. Every control has its own position and size inside the card:

layout:
  controls:
    - id: light-details
      type: button
      entity_index: 0
      xpos: 50
      ypos: 80
      width: 40
      height: 12
      tap_action:
        action: more-info

Use the individual control pages for complete examples and the options available to that control.

Choose where the value lives¶

A control can work with:

a Home Assistant entity such as a light, switch, number, select, or input helper;
a browser-local Flexible Horseshoe Card input;
an action that already names its own target, navigation path, or URL.

Use a Home Assistant entity when its state needs to be available outside the card. Flexible Horseshoe Card inputs are useful for display modes, chart periods, visible layers, and other settings that belong to the card itself.

Actions and availability¶

Buttons can define their own tap, hold, and double-tap actions. Other controls normally change their connected entity or Flexible Horseshoe Card input directly.

Set visibility: unavailable when a control should remain visible but cannot be used in the current situation. The control becomes visually subdued and does not respond to interaction.

See Actions for action types and Visibility for showing, hiding, or disabling controls.