Skip to content
Stand with Ukraine flag

Digital vertical bar

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

Preconfigured gauge to display any value reading as a vertical bar. Allows to configure value range, gradient colors, and other settings.

Widget Type
  • Latest
Category
  • Gauges & Indicators
Use Cases
  • Industrial Automation
  • Tank Level Monitoring

Who it’s for

Dashboard builders showing a level or a temperature that crosses zero, in a narrow column on a dark instrument-style board — a row of tank levels, a bank of process temperatures, anything read by comparing heights.

What it does

The Digital vertical bar draws a reading as a glowing segmented column filling from the bottom, colored blue below and red above as the value climbs. Over the default −60 to 60 range the fill crosses from the cool color to the warm one, with the value and a unit caption beside a 2.5×4.5 column that stacks into a row.

  • A vertical column matches level, height and temperature, which readers already picture as rising.
  • The two-color ramp splits the range into a low half and a high half, which suits a reading that crosses a midpoint rather than climbing toward a single limit.
  • A narrow tile is built to be repeated, so a row of columns compares directly.
  • Segmented fill and a glow give the instrument-panel look on a dark board.
  • Animated movement is on by default, so a drifting value reads as movement.
  • Units are converted, not just appended — the gauge respects the unit set on the key and converts to the unit chosen on the widget.
  • The Digital vertical bar shows one current reading: it is a styling preset of the same gauge engine as the plain Vertical bar.

How to set up

Data keys

The Digital vertical bar takes one datasource, one entity and one data key.

KeyRoleTypeDescription
Any numeric keyThe value the column fills toTimeseriesNumeric only. An attribute works equally well. The key’s own units and decimals override the widget-level ones.

Range

SettingDefaultEffect
Min value-60The bottom of the column
Max value60The top of the column
Units titleOn, emptyCaption beside the value; set it to the unit being shown
Bar color levelsBlue, redThe ramp the fill moves through
LabelOffThe caption above the value, off in this preset

How to customize

  • To match the scale to the measurement — set Min value and Max value; the default crossing-zero range suits temperature and not much else.
  • To caption the column — set Units title text, which ships enabled but empty.
  • To name the measurement — turn on Label and set its text, which this preset leaves off.
  • To put the color change where it means something — edit the Bar color levels so the boundary sits at the value that matters.
  • To tune the glow — set Neon glow effect brightness, or 0 to remove the effect.
  • To change how segmented the column looks — adjust Thickness of the stripes, or 0 for a solid fill.
  • To mark a limit on the scale — turn on Ticks and add that value.
  • To change the gauge’s shape — set Type to Arc, Donut, Horizontal bar or Vertical bar.

Tips

  • Put the color boundary at the midpoint the process actually has, not at the middle of the range. A two-color column is read as “below” and “above”, and readers assume the boundary is meaningful whether or not it was chosen.
  • Line up a row of these with a shared range and no per-column captions, naming them in the widget titles instead. Columns of equal scale are compared by height alone, and captions inside each tile break that scan.

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.