Monday.com

Gauge & Counter Documentation

Welcome to the Plugio Gauge documentation for Monday.com. This guide will help you set up and customize your dashboard widgets to visualize your board data effectively.

Getting Started

Follow these simple steps to add your first widget to a Monday.com dashboard:

  1. 1 Open any Monday.com dashboard and click Add Widget.
  2. 2 Search for "Plugio Gauge" and add it to your dashboard.
  3. 3 Click Settings on the widget to open the configuration panel.
  4. 4 Use the live preview editor to choose your visualization type, connect your boards, and configure your data.
  5. 5 Click Save to apply your configuration.

Visualization Types

Plugio Gauge offers three professional-grade visualization components:

1. Radial Gauge

Perfect for tracking KPIs against defined ranges. Ideal for monitoring task completion rates, budget utilization, or any metric you want to track against a target.

2. Progress Bar

Best for visualizing completion status across multiple dimensions. Add multiple series and target lines to compare values side by side — for example, "Completed Tasks" vs. "In Progress Tasks".

3. Numeric Counter

Designed for high-impact numbers. Use this to highlight critical metrics like total item counts, summed values from numeric columns, or any key figure from your boards.

Data Sources

Your widgets are powered by real-time Monday.com board data. The widget reads numeric columns from your connected boards and connected sub-boards.

Connecting a Board

In the Data tab, each series lets you select a board from the boards connected to your dashboard. The widget automatically loads all available numeric columns from the selected board.

Series

Each visualization supports multiple series. A series represents one data point — such as a column value from a specific board. You can add as many series as needed and customize each one with a name and color.

Value Input

The value field for each series accepts:

  • Static numbers: Enter any fixed number directly.
  • Variables: Type @ to reference a variable you have defined. Variables dynamically pull aggregated data from your boards.

Variables

Variables are reusable data queries that pull aggregated values from your Monday.com boards. They can be referenced anywhere a value is expected — series values, bounds, and target markers.

Creating a Variable

Go to the Variables tab and click Add Variable. You can also create one on the fly by typing @ in any value field.

Variable Types

  • Board Query: Select a board, a numeric column, and an aggregation operation (Sum, Average, Count, Min, Max). The variable will resolve to the result of that query in real time.
  • Formula: Write a mathematical expression using other variable names. For example: (completed / total) * 100. Useful for calculating percentages or combining multiple board metrics.

Using Variables

Type @ in any value field to see a list of your defined variables. Select one to use it. The widget will automatically resolve the variable to its current value when rendering.

Advanced Features

Dynamic Thresholds

Define custom color ranges (Green, Yellow, Red) for your Gauges. This provides immediate visual context — for example, turning red when a count exceeds a threshold you define.

Bounds

Set the minimum and maximum values for your Gauge or Progress Bar. Bounds can be static numbers or variables, allowing them to adjust dynamically as your board data changes.

Target Markers

Add reference lines to your Progress Bars to show goals or benchmarks. Like bounds, target values can be static or variable-driven.

Styling & Color Palettes

Choose from curated color templates or define your own per-series colors. The widget adapts to your Monday.com dashboard theme.

FAQ

Does my data leave Monday.com?

No. The widget operates entirely within the Monday.com platform using the Monday.com Apps SDK. All data fetching and processing happens within your Monday.com instance. We never store or transmit your board data.

Which column types are supported?

The widget supports all numeric column types in Monday.com, including Numbers, Time Tracking, and other numeric fields. Formula columns and text columns are not supported as data sources.

Can I use data from multiple boards?

Yes. Each series and each variable can reference a different board. The dashboard widget automatically loads all boards connected to your dashboard, including sub-boards.

Can I combine values from different boards in one metric?

Yes. Use Formula variables to combine values from multiple variables. For example, create a variable for Board A and another for Board B, then create a formula variable that sums them.

Support

Need help or have a feature request? We're here to help you get the most out of your Monday.com dashboards.

Email: [email protected]