---
title: "Bar Chart"
slug: "bar-chart-options"
description: "Customize Bar Charts in Pigment with label, color, and layout options to highlight trends, compare data, and improve visual clarity in Boards."
tags: ["Bar Charts", "Chart Customization", "charts", "Reporting Data Visualization "]
updated: 2026-06-05T14:19:31Z
published: 2026-06-05T14:19:31Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://kb.pigment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bar Chart

Bar charts visualize comparisons between categories of data and changes across multiple groups over the same period of time. This article covers how to prepare your View and configure Bar chart display settings.

![Bar chart displaying various cleaning product sales data with adjustable settings options.](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/Bar chart.png)

## Before you begin

How you set up your View affects how data appears in the chart. The following articles can help you prepare your data before customizing your chart:

- Use the [Pivot feature](/v1/docs/change-views-pivot-pigment) to change the axis and add/remove Dimensions.
- Use the [Filter feature](/v1/docs/filter-data-pigment) to remove Items from a List.
- Use the [Sort feature](/v1/docs/sort-data-in-pigment/#sort-your-metric-or-table-data) to change the order of Items in the chart.

## Configure Bar charts

Use the following settings to customize the appearance and layout of Bar charts.

### Bar chart settings

| Setting | Description | Options |
| --- | --- | --- |
| **Stacked values** | Stacks series values on top of each other. When turned off, series are displayed side by side (grouped). Ensure all series use the same units when stacking values. | Toggle on/off (*Turned off by default)* |
| **Bar direction** | Configures the bar direction. | Vertical bars or Horizontal bars |
| **Bar width** | Controls the width of each individual bar. | Move the slider to increase or reduce bar thickness. |
| **Show stacks totals** | Displays the total value at the top of each stacked bar. Only available when**Stacked values**is turned on. | Toggle on/off *(Turned off by default)* |

### Bar labels

| Setting | Description | Options |
| --- | --- | --- |
| **Show labels** | Shows or hides labels that display the value of each bar. | Toggle on/off *(Turned off by default)* |
| **Allow label overlap** | Allows labels to overlap so labels remain visible even when bars are too thin to display them normally. | Toggle on/off *(Turned off by default)* |
| **High-contrast labels** | Increase label contrast to improve readability and visibility against chart backgrounds. | Toggle on/off *(Turned off by default)* |

### X-axis

| Setting | Description | Options |
| --- | --- | --- |
| **Show gridlines** | Shows or hides labels that display the value of each bar. | Toggle on/off *(Turned off by default)* |
| **Label orientation** | Configures the orientation of X-axis labels. Longer labels automatically wrap. Use the diagonal or vertical option to improve readability and display more labels. **Diagonal labels** **are not supported** when multiple dimensions are displayed on the axis at the same time. | Horizontal, Vertical, and Diagonal |
| **Allow label overlap** | Allows labels to overlap so labels remain visible on X-axis even when data points are too close together. | Toggle on/off *(Turned off by default)* |

### Y-axis

| Setting | Description | Options |
| --- | --- | --- |
| **Show axis** | Shows or hides the Y-axis in the chart. | Toggle on/off *(Turned off by default)* |
| **Show gridlines** | Shows or hides the Y-axis gridlines in the chart. | Toggle on/off *(Turned off by default)* |

### Style

> [!NOTE]
> ℹ️ **Note**
> 
> Use the following settings to configure chart colors and themes. For detailed instructions and available color options, see [Customize Chart Colors](/v1/docs/customize-chart-colors).

| Setting | Description | Options |
| --- | --- | --- |
| **Color by** | Determines how colors are assigned to chart series. | **Theme** Use a predefined color palette. **Dimension Items** Assign a consistent color to each Dimension Item across charts. |
| **Color theme** | Applies a predefined color palette to chart series. Only available when **Color by**is set to **Theme**. | Pigment preset themes and Workspace palettes. |
| **Series colors** | Allows you to customize colors for individual series. Pigment preserves series color order when switching between themes. | Edit |

### Legend

| Setting | Description | Options |
| --- | --- | --- |
| **Show legend** | Shows or hides the chart legend. | Toggle on/off *(Turned on by default)* |
| **Legend position** | Sets the position of the legend. The legend becomes scrollable when additional series are displayed. | Bottom right, Top right, Bottom centered, or Top centered |