--- 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-08-31T12:44:03Z published: 2026-08-31T12:44:03Z canonical: "kb.pigment.com/bar-chart-options" --- > ## 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. ### Series | Setting | Description | Options | | --- | --- | --- | | **Color** | Changes the color of the selected series. | Select a color from the palette. | | **Show labels** | Shows or hides labels for the selected series. | Toggle on/off *(Turned off by default)* | ### 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)* | ### 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 | ### Text size | Setting | Description | Options | | --- | --- | --- | | **Global size** | Sets the default text size for all chart labels. Individual label types can be configured independently. | XS, S (default), M, L, XL | | **Bar labels** | Configures the text size of labels displayed on chart series. By default, this inherits the **Global size** setting. Use the drop-down to select a different text size. | Global size (default), XS, S, M, L, XL | | **X-axis labels** | Configures the text size of labels displayed on the X-axis. By default, this inherits the **Global size** setting. Use the drop-down to configure the text size independently. | Global size (default), XS, S, M, L, XL | | **Y-axis labels** | Configures the text size of labels displayed on the Y-axis. By default, this inherits the **Global size** setting. Use the drop-down to configure the text size independently. | Global size (default), XS, S, M, L, XL | | **Legend** | Configures the text size of labels displayed on chart series. By default, this inherits the **Global size** setting. Use the drop-down to select a different text size. | Global size (default), XS, S, M, L, XL | ### 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)* | | **Position** | Configures the position of bar labels. Available options depend on the selected orientation. When changing orientation, the selected position is preserved when possible. If the current position is unavailable, the position resets to **Centered** (default). | **Horizontal:** Top or Centered (default) **Vertical:** Bottom or Centered (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. | Horizontal, Vertical, and Diagonal | | **Max lines** | Configures the number of lines of text in X-axis labels. Up to five lines of text are allowed. | Move the slider to increase or reduce the lines of text. | | **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)* | ### 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 |