# Gauge
A **Gauge** widget is a type of **circular-arc graph** that displays the value of a measured parameter inside the arc. A needle points to the arc to show the value's location on the circle. Gauge widgets can be used in various contexts to provide a quick and easy way to understand the status or level of a measured value.
{% hint style="info" %}
The Gauge widget is available in Device Types, Devices, and Global Dashboards.
{% endhint %}
In the **Widget options** modal, enter a **name** as the **label** for your widget in the **Name** text box, and select the appropriate **data field** from the **Data field** drop-down list.
By default, the first row of the **range entity** is populated with '**from'** (lower bound) and '**to'** (upper bound) values that you have configured in the **Device Types -> Data fields** section in the **Uplink** tab, allowing you to apply a single color to the whole gauge.
To allow users to visualize different ranges of a measured value, such as soil moisture levels, a gauge can be divided into multiple ranges.
Click on the **+** button. The '**To'** text box of the first row enables you to enter the '**to'** value of the first range. As you enter the value in the **'To'** text box of the first row, it will automatically be added to the **'From'** text box of the second row, ensuring that the two ranges do not overlap. To add more ranges to the gauge, simply click the **+** button to add a new row. By default, each new range will start from the **'To'** value of the previous range, ensuring that the ranges do not overlap.
Select a color from the **color picker** in each row to assign a unique color to that range.
{% hint style="info" %}
By assigning specific colors to each range, users can quickly determine the status of the measured value and take appropriate action as needed.
{% endhint %}
Click on the **Gradient** checkbox if you want to enable a smooth transition of colors between each range.
To add a **color** to the **background** of the widget, click on the **Background color** box and choose a color from the **color picker**.
Click on the **Save** button.
The resulting **Gauge** widget looks something like this:
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.widgelix.com/get-started/widgets/gauge.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.