# Histogram widget

The Histogram Widget visually summarize the distribution of a continuous numeric variable by measuring the frequency at which certain values appear in the dataset.

The x-axis of the Histogram Widget has been split into buckets. For each bucket, a bar is drawn where the width of the bar represents the range of the bucket, and the height of the bar represents the number of features that fall into that range.

<figure><img src="/files/iPSdVkSjtqyuZ7LcxDE2" alt=""><figcaption><p><em>Histogram widget displaying distribution of pickups / droppoffs</em></p></figcaption></figure>

### Widget Data

In the Data section of the widget configuration, select a continuous numeric field. It's advisable to select a numeric variable with a continuous distribution for optimal results.

### Widget Display

In the Display options section, you can customize the number of buckets, which helps you control the granularity of your data representation. Additionally, you can also customize the limit values of your data that can be useful if you are looking to filter some features out your visualization.

<figure><img src="/files/wNKEYPC53WK4hLNv91So" alt=""><figcaption><p><em>Customize the number of buckets and limit of values</em></p></figcaption></figure>

In the display section, you can also use **formatting** to choose the unit of metrics displayed on the y-axis. Additionally, you can add **notes** that support [Markdown syntax](https://www.markdownguide.org/basic-syntax/).

### Widget Behavior

Within the "Behavior" section, you can define how your widget operates: choose between **"Viewport" or "Global" modes**. Additionally, you can make your widgets **collapsible**, allowing you to hide them when needed.

You can also enable or disable the widget’s filtering capability using the **cross-filtering** toggle icon. When enabled, the widget can filter itself and other components connected to the **same data source** or across **multiple sources** if they share the same property.

Learn more about widget behavior [here](/carto-user-manual/maps/widgets.md#widget-behaviour).


---

# 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.carto.com/carto-user-manual/maps/widgets/histogram-widget.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.