Probe mapping and dashboard labels

Map JSON probe keys to human-readable names in the dashboard so home page cards match physical locations.

Aosong AM2302 DHT22 temperature and humidity sensor module on a black breakout board
The DHT22 (AM2302) is the digital humidity–temperature sensor used in many DIY space builds. Photo: Suyash Dwivedi. CC BY-SA 4.0

Raw JSON exposes probes as numeric keys. The dashboard translates those keys into labels such as “North wall” or “Door bay” so visitors understand what they are reading without memorizing firmware indices.

Configuring mappings

Signed-in users add HTTPS feed URLs under dashboard temperature feed settings: detailed in configuring temperature feeds. Each enabled probe key gets a display name. Typos in keys silently hide readings even when the feed is healthy, so verify against curl output or JSON probe output schema.

Naming conventions

  • Include location and height if zones are similar (“East wall, high”).
  • Keep names short for mobile stat cards.
  • Document GPIO-to-key mapping on the bench for future you.
  • Use the average key only for summary history, not as a zone label.

Related guides

Start with temperature probes and their uses, then follow home page probe fetch for how mappings reach the public home page.