# Bar

Horizontal Bar charts display values for multiple dimensions, with two measures displayed as the width and color of the bar for each dimension group.

<table data-header-hidden><thead><tr><th width="306.3333333333333">Features</th><th>Quantity</th><th>Notes</th></tr></thead><tbody><tr><td>Features</td><td>Quantity</td><td>Notes</td></tr><tr><td>Required <a href="/pages/-M6lSZ5DiazUKg7k0_7Z#dimensions">Dimensions</a></td><td>1+</td><td>Minimum 1, no limit, null dimensions optional.</td></tr><tr><td>Required <a href="/pages/-M6lSZ5DiazUKg7k0_7Z#measures">Measures</a></td><td>1-2</td><td>Measure 1 = bar width, Measure 2 = bar color.</td></tr></tbody></table>

Bar charts are useful for showing relative values based on categories of information, particularly when the category label is long.

{% hint style="info" %}
You can convert Bar charts to the New Combo chart format. For more information, see [New Combo charts](/v8.3.0/immerse/immerse-chart-types/new-combo.md#duplicating-and-upgrading-other-chart-types-to-new-combo-charts).
{% endhint %}

### Sort By

You can sort by any chosen dimension or measure in ascending or descending order.

### # Of Groups

Display up to 100 groups of records. You can enter a value or use the slider to visually set the number of groups.

### Null Dimensions

Choose whether to show or hide Null values for your chosen dimension.

### Color Palette

You can use a custom palette to visually group values in your chart. By default, data points are colored arbitrarily with the same solid color. You can change the color for all columns, or apply colors to individual Dimension values.

If you set the **Color** measure, you can choose a gradient to visually express relative quantitative values.

### Custom Measure Formatting

You can also use custom measure formats for the values in your chart. See [Customizing Measure and Date Formats](/v8.3.0/immerse/measures-and-dimensions.md#customize-formats).

## Bar Chart Examples

Create a new Bar chart. Choose a **Data Source**. This example uses the official database of [UFO sightings](https://github.com/planetsig/ufo-reports/tree/master/csv-data)

Bar charts require a minimum of one dimension and one measure. For example, this chart categorizes on the **Dimension** of shape and uses the count of each *shape* as the **Measure**.

<figure><img src="/files/sgjBo6w5oGKtMJZzIFaW" alt=""><figcaption></figcaption></figure>

You can add any number of dimensions to your Bar chart. For example, you can combine the *shape* with the *state* where they were seen.

<figure><img src="/files/JL3iNEEklitTfMo8wbgi" alt=""><figcaption></figcaption></figure>

When you use two measures, the first measure (*shape*) is indicated by the width of the bar, while the second measure (*Duration\_Seconds*) is indicated by the color of the bar. Reversing the **Color Palette** makes the labels easier to read, in this example.

<figure><img src="/files/01uFjKm5RLeWB36yIZlo" alt=""><figcaption></figcaption></figure>

You can use a custom palette to color by dimension and visually group values in your bar chart. For example, this chart assigns colors to similar shapes (for example, rounded shapes such as *disk*, *circle*, *sphere*, and *oval* are all colored orange).

<figure><img src="/files/ax4rNOPmWpsgdMBoJ3mg" alt=""><figcaption></figcaption></figure>


---

# 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.heavy.ai/v8.3.0/immerse/deprecated-charts/bar.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.