Skip to content

Sensor

A sensor card displays live Home Assistant data. It has three modes:

  • Icon — shows an icon and can change to an on icon when the sensor is active.
  • Numeric — shows a large number with an optional unit and label. This is the default mode.
  • Text — shows a chosen icon and displays the live text state where a normal card label would appear.

Sensor cards are read-only — tapping them does nothing.

Sensor card showing 0 kph wind speed

Setting Up a Sensor Card

  1. Select a card and change its type to Sensor.
  2. Choose Icon, Numeric, or Text from the mode tabs. Numeric is selected by default.
  3. Enter a Sensor Entity — the Home Assistant entity ID of the sensor you want to display.

For Icon mode:

  1. Choose an Icon for the normal state.
  2. Choose an On Icon if you want a different icon when the sensor is active.
  3. Set a Label if you want custom text. If left blank, the entity name from Home Assistant is used.

For Numeric mode:

  1. Set a Unit — the unit label shown next to the value, for example °C, %, W, or kWh.
  2. Set a Label if you want custom text under the value. If left blank, the entity name from Home Assistant is used.
  3. Set Unit Precision if you want one or two decimal places.
  4. On a Large card, turn on Large Sensor Numbers if you want the top sensor readout scaled much larger.

For Text mode:

  1. Choose an Icon. This icon is always shown and does not change based on the sensor value.
  2. The live state from Home Assistant is shown where a Switch card label would normally appear.
  3. Open Advanced if you want to replace raw Home Assistant states with friendlier labels. For example, you can show Please empty when the sensor reports high, and Full when another sensor state reports low.

How It Works on the Panel

  • Icon mode treats active Home Assistant states such as on, true, home, playing, open, or unlocked as active and uses the on icon when configured.
  • Numeric mode displays the current value in large text, with the unit beside it and the label underneath.
  • Numeric mode uses the tertiary colour from Appearance, so it remains visually distinct from Switch and Trigger cards.
  • Text mode uses the same tertiary colour as Numeric mode, while keeping the normal Switch-style icon and label layout.
  • Text mode capitalises each word in the Home Assistant text and preserves line breaks. Advanced status translation is applied before the text is shown. Very long values are limited to roughly 256 characters so the panel stays responsive.

Example Sensors

EntityModeUnitWhat it shows
sensor.living_room_temperatureNumeric°CIndoor temperature
sensor.solar_powerNumericWCurrent solar generation
sensor.humidityNumeric%Relative humidity
binary_sensor.laundry_runningIconLaundry running or idle
text_sensor.washing_machine_statusTextRunning, Rinsing, or Finished
sensor.fan_levelTextlow, medium, or high