> 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/label.md).

# Label

{% hint style="warning" %}
***Note:*** please remember that web and mobile app widgets are set up separately in the Web Dashboard and Mobile App Dashboard sections correspondingly. They can still use the same datastreams to access the same data (Map widget is an exception – a different codebase is used for Map on mobile and web).
{% endhint %}

Label is used to show value of Virtual Pin e.g. length/distance, mass, duration, volume, temperature and other data types including strings. Also it can show level/progress bar (horizontal or vertical) and/or have widget colors changes based on getting different predefined values.

![](/files/-MVLsarxLaXFjqPmoAnN)

### **Settings**

* **Label** – name a Label widget so you or your client understand what it's about    <br>

* **Datastream** - select or create the data stream that will be the source of the data for the widget<br>

* **Content Alignment** – 2 options are available: Left, Right<br>

* **Background** <br>
  * With disabled option **Change color based on value** pick your own Background colour from palette
  * With enabled **Change color based on value** select the gradient scheme or set up your own one based on the **MIN** and **MAX** values of your choice and Background color

* **Level** – enable it by switching **Show level** on to visualize accordingly to values set in **MIN and MAX Value** fields below. Select position (vertical or horizontal) and level color.

![Label widget setup demo](/files/-MSiM-K5ZmEw635byY_J)


---

# 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:

```
GET https://docs.blynk.io/en/blynk.console/widgets-console/label.md?ask=<question>
```

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.