Skip to content

Cookie preferences

We use cookies for our own analytics, to see how our campaigns perform and, if you allow it, to load content from other services such as the Google site search. We never sell your data. Necessary cookies keep the site working and cannot be switched off. See our Cookie Policy for details and our Privacy Policy for how we handle personal data.

Security, load balancing and remembering your cookie choice.

Show us which pages people read and how they find the site, so we can improve it (Google Analytics).

Show us which of our ad campaigns bring visitors to the site and remember the campaign or partner link you arrived from (Google Ads, partner program). We do not use these cookies to build advertising profiles.

Load the site search from Google when you use it. Google sets its own cookies and shows ads in the search results.

© 2026 The ThingsBoard Authors
Try for free

ThingsBoard Cloud

Choose your data region

Your data stays in the region you choose, for residency and compliance. No credit card required.

Rather run it yourself? Install on your own servers

Label card

  • Widget
  • v1.0.0
  • Sep 1, 2026
  • MIT license
  • v4.2+ | Built-in

Displays a single label with optional icon.

Widget Type
  • Static
Category
  • Cards & Info

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.