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

Horizontal pipe

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

Horizontal pipe with fluid and leak visualizations.

Widget Type
  • Control
Category
  • SCADA
Use Cases
  • SCADA
  • Industrial Automation

Who it’s for

Anyone drawing a SCADA mimic where the connections matter as much as the equipment — a process line where an operator needs to see not only that a pump is running but that fluid is actually moving through the pipe it feeds, and whether that pipe is leaking.

What it does

The Horizontal pipe widget renders a pipe symbol with fluid and leak visualizations bound to live data. As a preconfigured SCADA symbol, it ships pointed at the platform’s own horizontal pipe SVG, and its behaviors bind flow and leak state to whatever keys the process reports.

  • Pipes as first-class elements — a mimic where the connections animate reads as a process, whereas one with static lines between animated equipment reads as a diagram.
  • Fluid visualization shows movement, so a running pump feeding a closed valve is visibly different from one feeding an open line.
  • A leak visualization gives a fault its own representation on the diagram rather than only in an alarm list.
  • A 1×1 default footprint, because pipes are laid out in runs of tiles rather than placed as single large widgets.
  • Being a SCADA symbol, it takes the same behaviors as any other — values that drive appearance, actions that command, and widget actions that navigate.
  • The Horizontal pipe draws one horizontal segment: corners, junctions and vertical runs need their own symbols placed alongside it.

How to set up

Data keys

The Horizontal pipe takes its data through the symbol’s behaviors rather than through a fixed key list.

AttributeScopeOperationDescription
Flow keyAnyReadBound to a Value behavior, this drives the fluid visualization — whether the pipe shows movement.
Leak keyAnyReadBound to a Value behavior, this drives the leak visualization.

Bind the flow behavior to something that actually indicates flow — a flow meter, a pump run state, a valve position — rather than to the presence of pressure. A pressurized static line looks identical to a flowing one on the instrumentation, and the pipe will animate as though fluid is moving when it is not.

Symbol

SettingDefaultEffect
SCADA symbolThe platform’s horizontal pipe SVGThe symbol rendered
BehaviorEmptyBindings from the symbol’s flow and leak elements to data
PropertiesEmptyThe symbol’s own configurable settings, exposed per instance

How to customize

  • To animate flow — add a Value behavior bound to the key that indicates movement.
  • To show leaks — add a Value behavior bound to the leak detection key.
  • To make the pipe navigate — add a Widget action behavior, so clicking a run opens the state covering that section.
  • To match the mimic’s background — set the card Background and Card padding so adjacent pipe tiles join without a visible gap.
  • To adjust the symbol’s own appearance — set its exposed Properties.

Tips

  • Set the padding to zero and match the backgrounds on every pipe tile in a run. Any padding leaves gaps between segments, and a mimic where the pipes visibly do not connect undermines the diagram it is meant to be.
  • Bind the leak visualization even when there is no leak sensor, using a derived condition instead — a pressure drop across a section, or a flow imbalance between two meters. A leak that only exists in an alarm list is not visible on the diagram where the operator is looking.

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.