Select the Gauge block and click Edit (1). Use the Data, Block and Card tabs (2) to configure it.
A Gauge block shows how close a result is to a goal. The percentage appears in the center, and the arc fills as the result gets closer to the goal. For example, a result of 75 with a goal of 100 shows 75%.
Understand the settings tabs
1Data
Choose what information the block uses.
2Block
Change how the information is displayed.
3Card
Style the container around the block.
Start with Data:The block needs information before it can show anything. The Block and Card tabs are optional. If you do not customize them, the block and its card follow the dashboard theme. Use these tabs only when you want this block to look different from the theme.
Configure the Data tab
In the Data tab, set up the two values the gauge compares. Both values are required:
For both Current Value and Goal, the screen gives you the same three choices:
Saved metric
Choose a metric that already exists in the workspace. The gauge reuses its calculation and number format. Use this when the same measure is already used in other blocks or dashboards.
Create new metric
Use this when you want to calculate a number from table data for this gauge.
1. Select table
Required
Choose the table that contains the information you want to measure. For example, choose Orders to calculate total revenue.
2. Column
Required
Choose what to measure, such as Revenue, Customer ID, or Created Date. The column type controls which Calculation Modes are available.
3. Calculation Mode
Required
Choose how the selected column becomes one number. For example, Sum adds revenue values and Count counts records.
How Calculation Mode changes the result:The selected mode turns many source values into the number plotted by the block.
Example values:102020
Sum
50
Average
16.7
Minimum
10
Maximum
20
Count
3
Count Distinct
2
Count Distinct returns 2 because the values contain two unique numbers: 10 and 20.
Choose Sum for a total
Use it for values you want to add together, such as total revenue, units sold, or hours worked.
Choose Average for a typical value
Use it for questions such as average order value, average rating, or average response time.
Choose Minimum for the smallest value
Use it to find the lowest price, shortest time, or smallest result.
Choose Maximum for the largest value
Use it to find the highest sale, longest time, or largest result.
Choose Count to count values
Use it to answer questions such as how many orders, customers, or records contain a value in the selected column.
Choose Count Distinct to count unique values
Use it when repeated values should count once, such as the number of different customers, countries, or products.
The available modes depend on the column type. Number columns support every mode. Text and date columns support Count and Count Distinct.
Filter
Optional
Limit the calculation with another condition from the selected table. Leave this empty to include every row.
Example: filter the selected table:If the gauge uses the Orders table, you can choose its Region column and set the condition to equals Europe. The gauge then calculates its result using only European orders. This filter belongs to this block, and it does not edit the Orders table. To let viewers choose the condition themselves, add a Filter block to the dashboard.
Build a custom metric
Optional
Use this for a more sophisticated calculation. A custom metric can use values from more than one table and combine those values with operations such as addition, subtraction, multiplication, or division. For example, divide total Revenue by total Orders to calculate average revenue per order.
Manual Value
Type the number yourself. Use this for a fixed number that does not need to come from a table, such as a target of 100.
1. Current Value
Required
Choose the result whose progress you want to show. For example, use a Saved metric or Create new metric for current revenue. Use Manual Value when you already know the result and want to type it directly.
2. Goal
Required
Choose the target that represents 100%. You can select a Saved metric, Create new metric, or enter a Manual Value. For example, a Current Value of 75 and a Goal of 100 fills 75% of the gauge.
The gauge is always a percentage of the goal:The gauge divides Current Value by Goal. The Goal represents 100%.
Configure the Block tab
The Block tab controls how the gauge looks. Every setting here is optional:
Style
Optional
Choose how the gauge arc and center value is drawn. This changes its appearance, not its data or calculation.
Default:
Uses the standard appearance from the dashboard theme
Classic:
Uses a traditional, familiar presentation
Glow:
Adds bright colors and a glowing effect
Modern:
Uses a clean, contemporary presentation
Pattern:
Adds patterns to the visual elements
Font Family
Optional
Set the font used for the percentage in the center of the gauge.
Progress Color
Optional
Choose the color of the filled part of the arc. The unfilled part shows the progress still needed to reach the Goal.
Value Typography
Optional
Set the Text Color, Font Size, and Font Weight for the percentage shown in the center of the gauge.
Hovering the gauge shows a tooltip with the formatted Current Value and Goal behind the percentage.
Configure the Card tab
The entire Card tab is optional. If you do not customize it, the card follows the dashboard theme. Use this tab only when you want this card to look different.
Card Style
Optional
Choose the style that fits the dashboard. This changes the card surface, border, corners, and shadow. It does not change the block's data.
Default:
Standard card
Elevated:
Rounded with a stronger shadow
Cyber:
Glowing colored edges
Claymorphic:
Soft three-dimensional shading
Flat Panel:
Square surface without a shadow
Glass:
Transparent, blurred surface
Neobrutalist:
Thick border and high contrast
Neuromorphic:
Soft surface blended into the background
Gradient:
Background that blends colors
Background
Optional
Show or hide the card surface. Available colors follow the selected style.
Icon
Optional
Add a symbol to the header. Choose its icon and background colors.
Title
Optional
Name the block. Keep it short and clear.
Description
Optional
Add context such as the unit or date range.
Footer
Optional
Add a source, update time, or short note at the bottom.
Typography is separate:Title, Description, and Footer each have their own color, font, size, and weight. These settings do not change the data inside the block.
