# 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="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-5e4ff9188956e5c53ddb538285ec9cc6f0a9d254%2Fimage.png?alt=media" 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="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-e10d9a1e8ec31fff3f342358ab8a1916449754b8%2Fimage.png?alt=media" 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](https://docs.carto.com/carto-user-manual/maps/widgets/..#widget-behaviour).