Examples

Complete cards to copy, then the tap_action snippets.

A card with no options

type: custom:mini-humidifier
entity: humidifier.xiaomi_miio_zhimi_humidifier_cb1

The default preset (zhimi.humidifier.cb1) fills in the rest: a name, the target-humidity slider, and indicators for water level, temperature, humidity and motor speed.

A generic humidifier

type: custom:mini-humidifier
entity: humidifier.xiaomi_miio_zhimi_humidifier_cb1
model: humidifier

For a device in the humidifier domain that is not a Xiaomi. The domain preset reads what Home Assistant guarantees for that domain - humidity, current_humidity, available_modes - and calls humidifier.* services, so an MQTT humidifier or a dehumidifier on a smart switch works as it is.

Custom name, secondary info and indicators

type: custom:mini-humidifier
entity: humidifier.xiaomi_miio_zhimi_humidifier_cb1
name: Bedroom
secondary_info:
  icon: mdi:fan
indicators:
  # The humidifier's own current humidity, an attribute of the entity.
  humidity:
    icon: mdi:water
    unit: '%'
    round: 0
    source:
      attribute: current_humidity
  # A room sensor beside the humidifier.
  room_temp:
    icon: mdi:thermometer-low
    unit: '°C'
    round: 1
    source:
      entity: sensor.sensor_temp_hum_pre_bedroom_temperature
  room_humidity:
    icon: mdi:water-outline
    unit: '%'
    round: 1
    source:
      entity: sensor.sensor_temp_hum_pre_bedroom_humidity

name overrides the entity name, secondary_info puts a line under it, and indicators is merged over the model's defaults: the bundled indicators the model brings stay on the card, and the ones you write are added (or override an indicator of the same name). source: attribute reads from the humidifier entity itself; source: entity reads from any entity in the installation. A mapper runs on the value you read - to round it, to convert between liters and percent, or to colour the reading, as in Indicators.

Action object examples

The snippets below are for the tap_action object, and the same shape works for an indicator's tap_action.

# call-service example
type: custom:mini-humidifier
entity: fan.xiaomi_miio_device
tap_action:
  action: call-service
  service: xiaomi_miio.fan_set_led_brightness
  service_data:
    brightness: 1

# navigate example
type: custom:mini-humidifier
entity: fan.xiaomi_miio_device
tap_action:
  action: navigate
  navigation_path: '/lovelace/4'

# url example
type: custom:mini-humidifier
entity: fan.xiaomi_miio_device
tap_action:
  action: url
  url: 'https://www.google.com/'

# none example - the shorthand for {action: none}
type: custom:mini-humidifier
entity: fan.xiaomi_miio_device
tap_action: none

# more-info for a custom entity example
type: custom:mini-humidifier
entity: fan.xiaomi_miio_device
tap_action:
  action: more-info
  entity: sensor.humidity

Any action that needs nothing but its name can be written as a bare string: tap_action: none and tap_action: more-info mean the same as tap_action: {action: none} and tap_action: {action: more-info}.