---
title: "Count Chart"
slug: "count-chart"
updated: 2026-05-12T21:22:36Z
published: 2026-05-12T21:22:36Z
canonical: "docs.processmaker.com/count-chart"
---

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

# Count Chart

The count chart displays a single data metric on a canvas. The following count chart shows how many records are in the "Department" [Collection](/v1/docs/collections#what-is-a-collection).

![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/image(41).png)

---

## Create a Count Chart

Follow these steps to create a count chart type for a Saved Search:

1. [View the search results for a Saved Search](/v1/docs/view-the-data-details-of-a-saved-search) in which to create this chart type. The **Data** tab displays the data details for that Saved Search.
2. Click the **Charts** tab. The **Charts** tab displays all charts created for this Saved Search.
3. Click the **+Chart** button. The **Create Chart** screen displays the **General** tab.

![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/ec52cb1c-81fe-42ad-851e-819489a6b710.png)
4. In the **Name** setting, enter the name of the chart. This is a required setting.
5. From the **Chart Type** group, select the **Count** chart type to visualize the results of this Saved Search. The **Count** chart type displays a single data metric on a canvas. See [chart example](/v1/docs/overview-of-saved-search-charts#count).

If you select the **Bar (Horizontal)**, **Bar (Vertical)**, **Line**, **Pie**, or **Doughnut** options, see [Create a Horizontal Bar, Vertical Bar, Line, Pie, or Doughnut Chart](/v1/docs/create-a-saved-search-chart#create-a-horizontal-bar-vertical-bar-line-pie-or-doughnut-chart) for their specific settings to create those chart types.

If you select the **List** chart option, see [Create a List Chart](/v1/docs/create-a-saved-search-chart#create-a-list-chart) for its specific settings.

**Bar (Horizontal)** is the default chart type.
6. Click the **Source** tab to configure from which Saved Search's results to visualize in the chart.

![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/815684a8-965e-4627-8a6f-22d060c55fcd.png)
7. From the **Metric** setting, select the chart contents from the Saved Search tabular-formatted results to aggregate as well as how to aggregate that data. The **Metric** setting options are numerically-based Saved Search results such as **#** that represents the ID for the Request, Task, or Collection record associated with that Saved Search. See [chart example that references how that chart data is aggregated](/v1/docs/charts-to-visualize-saved-search-results#example-using-a-count-chart).

Select from the following options how to aggregate the selected chart metric:

This is a required setting.
  - **Average:** The average is the arithmetic mean calculated by adding a group of values, and then dividing by the count of those items.
  - **Count:** The chart visualizes the number of values of the metric you select.
  - **Minimum:** The chart visualizes the minimum value of the metric you select.
  - **Maximum:** The chart visualizes the maximum value of the metric you select.
  - **Median:** The median is the middle value of a group of values that is calculated by sorting each of the values of the metric you select, then visualizing the middle value.
  - **Sum:** The sum is the arithmetic addition of each value of the metric you select. This is the default option.
8. In the **Query** setting, optionally enter a ProcessMaker Query Language ([PMQL](/v1/docs/pmql-syntax-to-search-processmaker-platform-data#what-is-pmql)) query from which to further filter the Saved Search's results. See the following topics for information how to use PMQL for Requests, Tasks, and Collections:
  - [PMQL Syntax for Requests](/v1/docs/search-using-processmaker-query-language-pmql#pmql-syntax-for-requests)
  - [PMQL Syntax for Tasks](/v1/docs/search-using-processmaker-query-language-pmql#pmql-syntax-for-tasks)
  - [PMQL Syntax for Collections](/v1/docs/search-using-processmaker-query-language-pmql#pmql-syntax-for-processmaker-collections)
9. Click the **Display** tab to configure the appearance and style of the Saved Search chart.

![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/ea92eb35-cb35-446c-8080-c8eb009a7313.png)
10. From the **Background Color** setting, select a color as the background for the count chart canvas.
11. From the **Icon** setting, select an icon to display beside to the left of the count chart metric. The **Line Chart** icon is the default icon.
12. In the **Label** setting, optionally enter a label to describe the count chart metric instead of the metric's default label.
13. Click **Save**. If a required setting does not contain a value or selection, the following message displays: **The given data was invalid.**. Otherwise, the chart and the following message display: **Successfully Created Chart**.