# Bar Chart

> Part of the NocoDB documentation (Product docs > Dashboard > Widgets). Index of all pages: https://nocodb.com/llms.txt. Any docs page is available as Markdown by adding `.md` to its URL.

URL: https://nocodb.com/docs/product/dashboards/widgets/bar-chart
Last updated: 2026-10-03

Configure a bar chart widget in a NocoDB dashboard to compare values across categories.

<img alt="Bar Chart" src={__img0} placeholder="blur" />

Use the **Bar Chart** widget in NocoDB dashboards to compare values across categories. It is good for showing trends, distributions, or comparisons between groups.

<AskNocoAI>
  <Prompt>
    Add a bar chart of [Amount] by [Region] to this dashboard
  </Prompt>

  <Prompt>
    Add a bar chart of the number of [tasks] per [Owner]
  </Prompt>

  <Prompt>
    Change the [widget name] chart to show only [this year]
  </Prompt>
</AskNocoAI>

## Title & Description

* **Title**: Enter a title for the bar chart widget. The title shows at the top of the widget.
* **Description**: Optional. Add a description that gives context or details about the data. The description shows below the title.

<img src="/img/v2/dashboards/widget-bar-chart-title.png" alt="Title" style={{ width: "50%" }} />

## Data Source

* **Table**: Select the table that supplies the data for the bar chart.
* **Records**: Select the records to include:
  * **All Records**: Shows all records from the selected table.
  * **Records from a view**: Uses the records of a specific view. The existing filters and sorts of the view apply.
  * **Specific Records**: Uses custom filters to select only some records.

<img src="/img/v2/dashboards/widget-bar-chart-source.png" alt="Title" style={{ width: "50%" }} />

## Display

### X-axis

* **Field**: Select the field whose values show as categories along the X-axis (for example, Product, Region, Status).
* **Sort By**: Select how to sort the categories:
  * **xAxis Value**: Sorts by the label values.
  * **yAxis Value**: Sorts by the numeric values in the chart.
* **Order**: Select Default, Ascending, or Descending order.
* **Include empty records**: Optional. Includes categories that have no values.
* **Include others**: Puts small or extra categories into one “Others” group. This makes the chart easier to read.

### Y-axis

* **Fields**: Select one or more fields that set the bar lengths. To compare fields, add more than one field.
* **Field Summary**: Shows the **Sum, Average, Min, or Max** of a numeric field.
* **Start at zero**: Makes the Y-axis always start at zero. Then you can compare bar heights more accurately.

<img src="/img/v2/dashboards/widget-bar-chart-axis.png" alt="Title" style={{ width: "50%" }} />

## Appearance

Change the look of the chart to make it easier to read and to match your dashboard:

* **Size**: Select the chart size (Small, Medium).
* **Show value in chart**: Shows the numeric values on the bars.
* **Show count in legend**: Shows the record count next to each category name in the legend.

<img src="/img/v2/dashboards/widget-bar-chart-style.png" alt="Title" style={{ width: "50%" }} />

---

## Related pages

- [Number](https://nocodb.com/docs/product/dashboards/widgets/number.md): Configure a number widget to show key metrics in a NocoDB dashboard.
- [Text](https://nocodb.com/docs/product/dashboards/widgets/text.md): Configure a text widget to add static text to a NocoDB dashboard.
- [Line Chart](https://nocodb.com/docs/product/dashboards/widgets/line-chart.md): Configure a line chart widget in a NocoDB dashboard to show trends and comparisons over time or across categories.
- [Pie Chart](https://nocodb.com/docs/product/dashboards/widgets/pie-chart.md): Configure a pie chart widget in a NocoDB dashboard to show how data is distributed.
- [Donut Chart](https://nocodb.com/docs/product/dashboards/widgets/donut-chart.md): Configure a donut chart widget in a NocoDB dashboard to show how data is distributed.
- [iFrame](https://nocodb.com/docs/product/dashboards/widgets/iframe.md): Use the iFrame widget to embed external web content securely in a NocoDB dashboard.