Label card
Displays a single label with optional icon.
Who it’s for
Dashboard builders who need a caption on the board itself — a section heading above a group of tiles, a legend beside a diagram, or a labelled band that tells an operator what the next three rows are about. Nothing here reads a device; the card exists to give a dashboard structure that survives being resized.
What it does
The Label card draws one line of text with an optional icon, sized to fill its tile. Typing Cold room — north with a snowflake icon gives a 4.5×1 band that heads the tiles beneath it and keeps its proportions whether the dashboard is viewed on a wall display or a phone.
- Text scales to the tile — auto scale grows and shrinks the caption with the widget, so one card works across breakpoints without a second configuration.
- The icon is optional and independent — any Material or MDI name at any size and color, or none at all.
- Caption font and color are set directly, so a heading can be weighted differently from a note or a warning band.
- The background is a color, a gradient or an image, which makes the card usable as a titled panel behind other content rather than only as a line of text.
- The Label card reads no data: it takes no datasource and shows nothing live, so it never goes stale and never prints
N/A.
How to set up
Data keys
The Label card takes no datasource and no data keys — it is a static widget, and there is nothing to wire up. Drop it on a dashboard and type the caption.
How to customize
- To write the caption — type it into Label, then set its font and color.
- To keep the text proportional as the tile is resized — leave Auto scale on; turn it off to pin an exact font size across every breakpoint.
- To add or drop the icon — turn on Icon, pick any Material or MDI name, and set its size and color.
- To use the card as a titled panel — set Background to a color, gradient or image and give the card enough height for the content it heads.
Tips
- Reach for the Label card before the widget title bar when a heading spans several tiles. A title belongs to one widget and moves with it; a Label card is positioned freely, so the heading stays put when the tiles underneath are rearranged.
- Give every heading card on a dashboard the same font, size and background, and vary only the text. Consistent bands read as structure; bands that each look slightly different read as content, and the eye stops using them to navigate.
Share Your Widget with the Community
Built a custom widget? Export it as a JSON from ThingsBoard and publish it to the IoT Hub through a simple 4-step wizard (Upload, Listing, Readme, Review & Submit). Share it with thousands of ThingsBoard developers worldwide and get featured in the catalog.