Examples¶

Minimal¶

type: custom:whisker-card
device_id: YOUR_DEVICE_ID

Custom title¶

type: custom:whisker-card
device_id: YOUR_DEVICE_ID
title: Cat HQ

Robot color¶

The model (Litter-Robot 4 / 5 / 5 Pro / Evo) is auto-detected; pick the color to match your unit (white is the default).

type: custom:whisker-card
device_id: YOUR_DEVICE_ID
color: black

Gauge percentages¶

type: custom:whisker-card
device_id: YOUR_DEVICE_ID
features:
  - percentage

Pet weight history graph¶

Auto-detects per-cat weight sensors. List them explicitly to control which appear:

type: custom:whisker-card
device_id: YOUR_DEVICE_ID
chonk:
  graph_type: history
  kitties:
    - sensor.tuna_weight
    - sensor.mittens_weight
  hours_to_show: 168

Pet weight statistics graph¶

Plots long-term statistics (mean/min/max) — great for spotting trends over weeks or months. This is the default for new cards added through the dashboard UI:

type: custom:whisker-card
device_id: YOUR_DEVICE_ID
chonk:
  graph_type: statistics
  days_to_show: 30
  period: day
  stat_types:
    - mean
    - max
    - min
  chart_type: line

Stacked line chart:

type: custom:whisker-card
device_id: YOUR_DEVICE_ID
chonk:
  graph_type: statistics
  chart_type: line-stack
  stat_types:
    - mean

Hide the graph entirely:

type: custom:whisker-card
device_id: YOUR_DEVICE_ID
chonk:
  hide: true

Order matters:

type: custom:whisker-card
device_id: YOUR_DEVICE_ID
footer:
  - total_cycles
  - status_changed
  - pet_weight
  - last_seen

type: custom:whisker-card
device_id: YOUR_DEVICE_ID
footer:
  - hopper_status
  - hopper_connected