---
title: "Chart"
slug: "chart"
abstract: "How to use the Chart component to create reports."
---
# Chart

The **Chart** component lets you create reports of current and past events, and visualize [audit data](https://doc.sitecore.com/ch/en/developers/cloud-dev/auditing.html). It uses historical reporting to represent Sitecore Content Hub data as a two-dimensional chart, which you define on the **Historical** tab.

> [!note]
> A second type of report using operational reporting is available, but it has deprecated. Previously, this was used to represent one-dimensional data such as the total number of assets associated with a geographical region, but we now recommend you use the [**Search** component](https://doc.sitecore.com/ch/en/users/content-hub/configure-chart-view-settings.html "Configure Chart view settings") configured in chart view instead.

By applying a [chart filter](https://doc.sitecore.com/ch/en/users/content-hub/chart-filter.html "Chart filter"), you can add a time dimension to a chart as shown in the following example.

![Chart and chart filter example](https://doc.sitecore.com/api/markdown-image/ch/en/users/content-hub/images/chart_and_chart_filter_example.png)

## Add a chart

To add a chart:

1. On the menu bar, click **Manage** :mdiCogOutline:.
2. On the **Manage** page, click **Pages**.
3. On the **Pages** page, select the page you want to modify.
4. On the **Layout** tab, [add the page component](https://doc.sitecore.com/ch/en/users/content-hub/add,-modify,-or-delete-page-components.md "Add, modify, or delete page components").
5. Click the component to open its details page.
6. Depending on the type of report, click one of the following tabs and define the associated properties:

    :::tab{title="Dashboard"}

    Use this tab to use operational reporting based on a saved search. This method is deprecated in favor of using a [**Search** component](https://doc.sitecore.com/ch/en/users/content-hub/configure-chart-view-settings.html "Configure Chart view settings").

    | **Setting** | **Description** |
    | --- | --- |
    | **Create saved search** | Opens the **Dashboard builder** dialog box where you can [create a saved search](https://doc.sitecore.com/ch/en/users/content-hub/manage-saved-searches.html). |
    | **Select a search** | Select the check box next to the search you want to use when rendering the chart. |
    | **Select chart dimensions** | After selecting a saved search, choose a chart dimension. This groups data into categories (for example, the *asset media* dimension groups data into various categories such as *videos*, *vectors*, *images*, and so on). |

    :::
    :::tab{title="Historical"}

    Use this tab to configure the component to use historical reporting. You can do so on the **Visual** tab or the **Raw** tab but we recommend you use the **Visual** tab.

    <details>
    <summary>Visual tab</summary>

    | **Section** | **Description** |
    | --- | --- |
    | **Filters** | Click **Add** to select the filters to use when displaying chart data and, in the **Add filter** dialog, click one of the following tabs to select the filters:<br><br><ul><li>**Events** - to filter on an event type.</li><li>**Definitions** - to filter on an entity definition and item.</li><li>**Property filters** - to filter on an entity definition property and value.</li><li>**Document filters** - to filter on an entity definition, user, location, log type, and rendition.</li></ul><br><br>Click **Evaluate filters** to determine how many documents fulfill the filter requirement. |
    | **Dimensions** | To set the principal dimension, click **Set** and specify associated properties:<br><br><ul><li>**Taxonomy filters** - to filter on selected taxonomy and definition.</li><li>**Property** - to filter on an entity definition, type, property or culture.</li><li>**Document filters** - to filter on a document property (such as *delivery mode*).</li><li>**User** - to filter on a user type.</li><li>**Event** - to filter on an event type.</li></ul> |

    When defining filter values in the **Add filter** dialog, enter a value and press Enter after each value.

    </details>

    <details>
    <summary>Raw tab</summary>

    | **Section** | **Description** |
    | --- | --- |
    | **Filters** | Define a chart filter to limit the amount of data used in the chart (for example, to limit data to documents, use the filter *documents*). |
    | **Dimensions** | To set the principal dimension, click **Set** and specify associated properties:<br><br><ul><li>**Taxonomy filters** - to filter on selected taxonomy and definition.</li><li>**Property** - to filter on an entity definition, type, property or culture.</li><li>**Document filters** - to filter on a document property (such as *delivery mode*).</li><li>**User** - to filter on a user type.</li><li>**Event** - to filter on an event type.</li></ul> |

    </details>

    :::

7. After selecting the principal dimension, specify the following fields:

    | **Field** | **Description** |
    | --- | --- |
    | **Sorting** | Sorts results alphabetically or using a metric. |
    | **Top** | Filters out a subset of the entire data results. This field is useful when the X-axis contains a lot of grouping values or when trying to exclude some observed outliers from the report. |
    | **Sortingorder** | Sorts the derived results in ascending or descending order. |
    | **Group by** | Click **Set** to group results by based on the selected type. |

8. For operational reports, in the right pane, define chart properties.

    | Property | Description |
    | --- | --- |
    | **Chart title** | The title displayed above the graph. |
    | **Chart sizes** | The size of the graph on the page (small, medium, or large). Multiple graphs can be added on a single page using multiple chart components. |
    | **Chart type** | How the data is presented (as a number chart, pie chart, or donuts chart). |
    | **Metric label** | The text label displayed on the Y-axis of a column chart graph. |
    | **Metric** | Type of aggregation to apply to chart data. |
    | **Limit dimensions slices** | Filter that limits the data to a subset of the results. This is useful when the X-axis contains a lot of grouping values or when you want to exclude outliers. |
    | **Sorting** | How chart data is sorted (alphabetically or by metric.) |
    | **Sorting order** | The sort order (ascending or descending). |

9. To view the chart, in the top-right corner of the application window, click **Preview**.
10. Click **Save and close**.

> [!note]
> To remove a saved search, open the **Dashboard builder** and, on the **Saved** tab, next to the saved search click **More actions** :mdiDotsHorizontal: and then click **Delete**.

> [!tip]
> You can print and download *large* charts. To do so, on the **Dashboard** tab, click **Preview**. In the **Preview** window, click **Chart context menu** :mdiDotsHorizontal: and choose one of the options. The **Download reporting logs** option generates a JSON file that includes all documents with the selected filters.