Barchart

🧭 Overview

Bar charts are used to compare data, identify trends, simplify complex information, and highlight differences between categories. Their clear visual structure makes interpretation easy, allowing insights to be quickly and effectively understood.

📊 Example Use Case

• Sales by region or product type

• Monthly signups by acquisition channel

• Inventory counts by category

⭐ Key Features

• Categorical Comparison: Visualize one or more categories using bars of varying height.

• Custom Ordering: Sort bars by column value or custom measure.

• Grouping: Group data by another dimension (e.g., monthly product sales grouped by year).

• Display Options: Toggle values above bars for quick reference.

• Sentiment Coloring: Apply positive/neutral/negative color codes for immediate visual cues.

• Precision & Units: Control number formatting and unit display for better KPI clarity.

Configuration

New Barchart

Learn how to create a barchart using the new design with this step-by-step guide. Explore the interactive walkthrough below to get started quickly, then dive into the full configuration reference table for in-depth details.

Chart Configuration Step-by-Step

	Option	How does it work?
Dimension
	Bar category	The bar category corresponds to a column in your dataset, such as 'Product Type'.
	Order bars	This option allows to order bars either by column or by custom value. By column Bars are ordered based on the selected column. By default, they follow an ascending order—starting with numerical categories, followed by alphabetical (A-Z). This order can be reversed. By custom value Bars are ordered based on the selected measure. For example, if the category is 'October' and the bar height is '10', you need to set the value to 10 for this bar to appear first.
	Group bars	Bars are grouped by category. For example, product types tracked monthly over a long period can be grouped by year.
	Change date format	You can change the display format by selecting an option from the dropdown. Common D3 formats are suggested. Note: Your column must be in a date format for this option to work.
Measure
	Bar height	The bar height represents a value from your dataset. You can select an aggregation method from the menu, which may vary depending on the chart type.
	Precision	Precision determines the level of detail in how your values are displayed. By default, measures use a .2f format, meaning they are shown with two decimal places. Example: A value of 3.14159 will be displayed as 3.14 when using .2f formatting.
	Unit	Unit represents the total quantity or category being measured for a KPI. It defines what the values correspond to, providing context for better interpretation.
	Sentiment	Four different sentiment statuses (positive, warning, negative, neutral) can be used to color bars, enhancing visual distinction. Note: Sentiments can be customized in the app theme.
	Show value on bar	Displays all values above the bars for easy visibility.
Additional parameters
	ID	Unique chart Id
	Add complementary value	The complementary value is displayed in the data label, providing additional context and making it easier for viewers to interpret the data at a glance. It is possible to add a precision, an unit and a sentiment.
	Add user chart guide	Lead your chart viewers through the narrative of your data.
Chart performance		Technical performance

Style Configuration

	Option	How does it work?
Theme
	Bars	Customize the bar color to align with your branding preferences.

Legacy Barchart

This page provides a step-by-step guide for creating a barchart using the legacy design.

*Mandatory parameters

Section	Option	Configuration tutorial
	Dataset*	Select the dataset used by the chart
	Label*	this will define the name of each of the bars you want to display. Select the column containing bar label
	Value*	Select the column containing the value
	Heatbar - by using Sentiments	Add a heat bar to highlight variation/evolution of different categories by using sentiments (Add units, precisions and sentiments)
	Heatbar - with custom labels (code mode)	Switch in code mode and add a labels array to the sentiment configuration. The values of the labels array will be matched with the values of the range array.
Legend	Display legend	Toggle to activate legend display
Legend	Default bar selected	Choose the first, last or the name of the label
Legend	Additional info	Add another column for more information on the legend
Sort	Bars order - Configuration type	Use it to order bars
Groups	Groups	This option let you group multiple columns together Select a column containing grouping of bars
Groups	Groups order	Use it to order groups
Groups	Groups additional info	Add another column for more information on the group
Display	Display all values on top of bars	Tick to display values on top of bars
Display	Scroll graph to the right	Tick to change the animation when arriving on the chart
Display	Scale	Use it to define the bars scale. Choose 2 bounds if you’re displaying %, try a 0 to 100
Display	Disable zoom in animation	The chart will be zoomable, but will not transition to a zoomed state. All bars will remain visible.
Display	Disable zoom	he chart will not be zoomable. All bars will remain visible.
Display	Recycle group colors	Reuse groups color when chart data changes (filters or requesters). Note: groups must be setup, see Groups section
Display	Custom date tick format (for date labels)	This option lets you display your dates just the way you want. Insert d3 time format (.i.e. ‘%Y’ to display just years.)
Display	Size	Enter a proportion of the total screen Use on multiple charts onlyEnter a number from 0 to 1
Display	Mobile size	Enter a proportion of the total mobile screen. Use on multiple charts onlyEnter a number from 0 to 1
Display	Custom CSS class	amazing-class | Set a custom CSS class to target this specific chart with CSS
Tutorial	ID	Enter an ID. Change the ID to display the tutorial again. All tutorials with the same ID will be displayed only once.
Tutorial	Message	Enter your message | This will be displayed to your users
Tutorial	Always show this tutorial	By default the tutorial is shown once only