> For the complete documentation index, see [llms.txt](https://docs.airdev.co/canvas-pages-and-modules/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airdev.co/canvas-pages-and-modules/modules/4-column-dashboard-widgets.md).

# 4-Column Dashboard Widgets

## Overview

The block includes eight common dashboard widgets for displaying metrics, charts, progress bars, and recent activities.

![](/files/-MXZBg8XxmyGSBKYzlZD)

## Structure

* When this block is added to a page, it is placed within a group called **Blocks container 860 (do not rename)** on the page. This group contains the responsive settings for all blocks.
* This block contains four main groups:
  * **Group Responsive metric and chart**
    * **Group Inner standard metric tile** contains text elements for displaying metrics
    * **Group Inner chart container** contains a Bubble chart element for displaying graphs
  * **Group Responsive metric and progress bar**
    * **Group Inner metrics container** contains text elements for displaying multiple metrics
    * **Group Inner progress bar chart container** contains a progress bar and text element&#x20;
  * **Group Responsive small metrics and chart** and **Group Responsive small metrics and progress bar** contain smaller versions of the aforementioned widgets
* This block also includes a reusable element that you can customize:
  * [**filters\_template**](https://docs.airdev.co/canvas-pages-and-modules/v/3.0.0/reusables/applyfilters)

## How to set up standard metrics widgets

* Update the data source of the group

![](/files/-MXZShxznC0xSMl_KUxZ)

* Update the conditional statements on 'Text number'
  * These conditional statements are used to format the text to display a decrease, increase, or no change in the numbers.

![](/files/-MXZT0qCyD20P9QRO7J7)

![](/files/-MXZSo1NyHLzn-PFNnJg)

## How to set up the chart widgets <a href="#how-to-set-up-the-chart-widget" id="how-to-set-up-the-chart-widget"></a>

* Update the data source of the Bubble chart element

![](/files/-MXZTrX0qMP4WBG9MVHp)

## How to set up the metrics widgets <a href="#how-to-set-up-the-metrics-widgets" id="how-to-set-up-the-metrics-widgets"></a>

* Update the data sources of all text elements within the group

![](/files/-MXZc_UKMs3kf5q7sgM8)

## How to set up progress bar widgets

* Update the data source of the group

![](/files/-MXZdzRgnS1Lz6Ff0ImG)

* All progress bar elements are Bubble elements that can dynamically display a percentage:

![](/files/-MXZe7I8-vY0GUF8mk8N)

* For example, if you would like to display which percentage of revenue comes from a specific source (e.g., Shopify), you can set that progress bar's "Percentage" data source to be that dynamic expression (e.g., \[Shopify Revenue numeric value]/\[Total Revenue numeric value])

![](/files/-MXYTzkL3R5mk1B0a9CS)

## Other updates

* Each widget group includes a primary action button
* To use, please remember to add a workflow to the button.
* To hide, please select ***Group responsive primary action container*** and uncheck the box for *This element is visible on page load*.

![](/files/-MXZf90fV_Id7chpzbEh)
