---
title: "Configuring Bar Chart Widget"
slug: "configuring-bar-chart-widget"
updated: 2025-07-10T13:21:49Z
published: 2025-07-28T06:00:01Z
canonical: "documentation.encodify.com/configuring-bar-chart-widget"
---

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

# Configuring Bar Chart Widget

## How to create a Bar Chart Widget

---

To add a Bar Chart widget, follow these steps:

1. Navigate to the **Widget Library**(see [Manage Widgets](/v1/docs/manage-widgets) for more details).
2. Locate **Bar Charts** and click on the card.
3. Enable or disable the **Widget Refresh Rate (in seconds)**. If enabled, set a time interval — the widget will automatically refresh unless previous request is still in progress.
4. Select the **Module** and the **Field** for the Horizontal Axis.
5. Specify sort order: **Ascending** or **Descending**.
6. Enable **Add bar with uncategorised items** if needed.
7. For date aggregation, specify time interval (Day, Week, Month, Quarter, or Year), using the **Group Date Values By** field.
8. Configure the **Vertical Axis** display:
  - ******Field Summary** – displays the total number of items in the module
  - **Aggregation******– aggregates values from a numeric field.
9. For **Field Summary**, configure:
  - **Field** (required): The numeric field to summarise.
  - **Aggregation Type** (required): e.g. sum, average.
10. Apply a **Filter** to limit the dataset shown. Use **Saved Filters** to select an existing module filter, or choose **Custom Filter** to create a new one.

![Bar chart displaying data with options for widget refresh rate and sorting methods.](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/Screenshot 2025-05-06 174230.png)

1. Go to the **Appearance** tab to adjust the visual settings or click **Create**to save with default settings:
  - Choose whether to always show values on the bars by enabling or disabling **Show values all the time**.
  - Optionally, enter a **Target Value** and an optional **Target Label**.
  - Select a **Target Line Color**.
  - Define **Chart Colors & Styles**: choose either a **Color Palette** (multiple colours) or a **Single Colour**.
  - Optionally, add labels for the**Horizontal Axis and/or Vertical Axis**.
  - Optionally, enter a **Description** to display at the top of the widget.
2. Click **Create** to confirm your settings and add the widget.

![Bar chart displaying data for eight categories with varying heights and labels.](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/Screenshot 2025-05-06 174254.png)