> For the complete documentation index, see [llms.txt](https://docs.blynk.io/en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blynk.io/en/blynk.console/widgets-console/gradient-ramp.md).

# Gradient Ramp

### Overview

The Gradient Widget provides intuitive data visualization through a sloped bar with a smooth color gradient. It’s designed to represent values on a continuous scale, helping users interpret trends, thresholds, and performance metrics at a glance.

Common use cases include displaying:

* Signal strength
* Temperature levels
* Battery status

***

### Settings

| Setting             | Description                                                           |
| ------------------- | --------------------------------------------------------------------- |
| Title               | Optional. Set a custom name for the widget.                           |
| Datastream          | Choose the datastream to visualize.                                   |
| Override Min/Max    | Optionally override the datastream’s default min/max value limits.    |
| Gauge Shape         | <p>Choose visual style:<br>• Solid<br>• Ascending<br>• Descending</p> |
| Show Min/Max Values | Toggle display of the min/max values on the widget.                   |
| Show Value          | Toggle display of the current value.                                  |
| Show Bottom Label   | Show or hide the label below the widget.                              |
| Ramp Color          | Choose a solid color or gradient appearance.                          |

<figure><img src="/files/TEqvZs9w0C58yGoP4bHG" alt=""><figcaption><p>Gradient Ramp</p></figcaption></figure>

### Limits

* Bottom Label: Maximum 100 characters

***

### Controlling Widget from Hardware

You can update widget properties programmatically using:

```
Blynk.setProperty(vPin, "widgetProperty", "propertyValue");
```

Where:

* vPin — Virtual pin assigned to the widget
* widgetProperty — Property you want to change
* propertyValue — New value for that property

{% hint style="danger" %}
Warning: Avoid placing Blynk.setProperty() in the loop() function — this may flood the server and disconnect your device. Use timers or event-based updates instead.
{% endhint %}

#### Supported Properties

You can change the following properties from hardware or via the HTTP API:

* label
* isHidden
* isDisabled<br>

**Example (hardware):**

```
Blynk.setProperty(V1, "isHidden", "true");
```

**Example (HTTP API):**

```
https://{server_address}/external/api/update/property?token={your_32_char_token}&pin=V1&isHidden=true
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.blynk.io/en/blynk.console/widgets-console/gradient-ramp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.