Docs
Widgets / directory

Labeled Value

LABELED_VALUE_DISPLAY

String template display with inline placeholder replacement for the current pin value.

At a glance

Default4 x 2
Minimum2 x 1
Resizeboth
Pinrequired
Interactiveno

Behavior

  • Useful when the unit or framing text matters more than the number tile itself.
  • Good for status messages like Temp: 24.8 C or Pump state: ON.
  • Stays visually compact in dense dashboards.

Firmware contract

Publish the raw value and let the widget format it in the UI layer.

On the app side this widget snaps to the 8-column square grid and uses both resizing. Its raw type is LABELED_VALUE_DISPLAY and the matching icon token in the app is tag.fill.

Pin support: A configured pin is required before the widget becomes meaningful.

Transmission: Payload format depends on the widget type and the selected pinType.

Canvas preview

docs.widget.preview
Labeled Value24.8 °C
Labeled Value
stable
STATUS

Widget contract

PropertyValue
Raw typeLABELED_VALUE_DISPLAY
Default size4 x 2
Minimum size2 x 1
Resize modeboth
Pin requirementrequired
Pin supportSee behavior and firmware contract above
Interactiveread-only / service
TransmissionDepends on the widget payload type

Allowed pin families

Bound to the configured pinType and limited by how the current app/connector serialize the widget payload.

Transport path

Payload leaves the canvas through the dashboard transport and lands on the selected virtual, digital or analog endpoint.

Operational limits

Server-side behavior may still depend on board library support and project policy.

Configuration surface

  • Color, label and position are stored in the dashboard profile.
  • Use the app-side widget config sheet to tune behavior per widget type.

Limits and caveats

  • Server-side behavior may still depend on board library support and project policy.

Layout notes

Canvas footprint

4 x 2

Default footprint in the Plynx canvas before user resizing.

Resize floor

2 x 1

The minimum size accepted by the app during drag-resize.

Interaction model

Display

Whether the user edits state directly or only reads it.

Related widgets

Value Display

Fast numeric readout for single values like temperature, current or uptime.

Gauge

Circular analog-style meter for sensor values and percentages.

LCD

Character display widget inspired by classic 16x2 LCD modules.

LED

Simple indicator surface where brightness or on/off state mirrors a pin.