---
title: Add dimension time series cards
slug: '1555'
canonical_url: https://docs.coveo.com/en/1555/
collection: coveo-analytics
source_format: adoc
---
# Add dimension time series cards
Coveo Analytics dashboards offer many ways to [review the data](https://docs.coveo.com/en/1542/) collected by [Coveo Analytics](https://docs.coveo.com/en/182/).

You can, among other things, add dimension time series cards to dashboards to quickly evaluate values of dimensions over a certain period such as the number of clicks by countries over the past few months.

## Add dimension time series cards in dashboards

. In an existing dashboard, access Edit mode by clicking **Edit** in the upper-right corner.

> **Note**
>
> In a [new dashboard](https://docs.coveo.com/en/1631/), the report is in Edit mode by default.

. In a section, click **Add card to section** to access the **Add a Card** dialog.

> **Tip**
>
> You can also [duplicate an existing card](https://docs.coveo.com/en/1804/) with [copy16px], and then only modify what needs to be different.

. In the **Add a Card** dialog:

.. Select **Dimension time series**.

**Example**

You can create a dimension time series that presents the number of queries per country over the past few months.

![Dimension time series card | Coveo](https://docs.coveo.com/en/assets/images/coveo-analytics/dimensions-time-series-card-example.png)

.. In the first input, enter a meaningful **Card title**.

> **Note**
>
> When you leave the input empty and save the dashboard, the card title will be [**Selected Metric**] **per** [**Selected Dimension**].

**Example**

`Click Event Count per Country Over the Past 6 Months`

.. Under **Show the evolution over time**:

... In the first dropdown menu, use the **Filter** box to find and select the [metric](https://docs.coveo.com/en/263/) to be shown in the time series.

**Example**

**Click Event Count**

... In the second dropdown menu, use the **Filter** box to find and select the dimension for which the values will be shown in the time series and in the dimension box.

> **Note**
>
> You can review the evolution of the five most popular dimension values based on the selected metric per graph.

**Example**

**Country**

.. When you report on a custom event and on a search or click event (you added a filter or selected a dimension or metric related) at the same time, or on an all event category metric or dimension (for example, Unique User IP and Browser), choose to **Create a relation using** the **Last search** or the **Visit** between the event categories.

> **Tip**
>
> Select **Last search** in situations where the last query performed by the user is the reason for the custom event.
> 
> For example, in Salesforce, when agents attached a result to a case (`caseAttach`), the last query they made gave them the results they used to do the custom event.
> 
> On the other hand, select **Visit** in situations where none of the queries performed by the user during the visit resolved their matter.
> 
> For example, when one of your clients creates a case (`caseCreate`), they, more often than not, tried to get the information they needed by querying on the subject of their matter before doing the custom event.
> You can then use these queries to create knowledge base articles and therefore fill the content gap.

> **Notes**
>
> * Custom data can only be leveraged when using the Coveo UA Protocol.
> If your Coveo implementation uses the [Event Protocol](https://docs.coveo.com/en/o1n91230/), custom event types shouldn't be added to a report since they won't function as expected.
> 
> * The **Create a relation using** parameter has no effect when you report only on search and click events.
> 
> * **Last search** links each custom event to the query immediately preceding (if any) and **Visit** links each custom event to all queries performed during the user visit in which the custom event happened.

.. (Optional) In the **Advanced Settings** section:

*** Click icon:filter-add-2[alt=filter-add-2,width=16], and then [create one or more dimension filters](https://docs.coveo.com/en/2050/).

**Example**

`Country is not India`

*** In the **Header destination link** input, [set a destination link](https://docs.coveo.com/en/1794/) when clicking the card title.

*** Under **Graph display option**, when you want to see metric values on top of every time series points, select the **Show metric** option.

![Line graph showing metric data over time | Coveo](https://docs.coveo.com/en/assets/images/coveo-analytics/time-series-card-with-data-over-time.png)

*** Under **Legend display options**, modify the default settings:

**** [[Trend]]When you want to see trend data relative to the previous equivalent period as the one that's currently selected, select the **Show trend** option.

The trend value appears next to the dimension value as a percentage with an up or a down arrow respectively indicating an increasing or a decreasing trend.

![Trend value in dimension time series card | Coveo](https://docs.coveo.com/en/assets/images/coveo-analytics/time-series-card-trend-value.png)

When hovering the trend icon, you see the metric value (total) for the current period and previous equivalent period.

The option is turned off by default, because calculating the trends increases the dashboard complexity and slows down the dashboard generation.
Enable this option when you find the trend information useful.

**** When you don't want to see the average [average] and peak [peak] of each dimension value based on the [selected interval](https://docs.coveo.com/en/1542#change-the-time-series-card-interval) (hour, day, week, or month) and for the selected period, clear the **Show average** and **Show peak** checkboxes.

**Example**

The highest number of clicks during a day last week.

*** Under **Display as**, select the time series to be shown using **Line** or **Bar** charts.

.. Click **Add Card**.

. If you selected the **Custom Event Count** metric, back on the dashboard, click the metric name and edit it to better match the related custom event.

**Example**

Cases Deflected

. Back on the dashboard, click **Save** in the upper-right corner.

## Required privileges


The following table indicates the required privileges to view and edit dashboards from the [**Reports**](https://platform.cloud.coveo.com/admin/#/orgid/usage/reports/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/usage/reports/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/usage/reports/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/usage/reports/)) page and associated panels (see [Manage privileges](https://docs.coveo.com/en/3151/) and [Privilege reference](https://docs.coveo.com/en/1707/)).

Access to dashboards or part of their content may be further restricted as a function of the member (see [Manage access to reports](https://docs.coveo.com/en/1888/) and [Manage permission filters](https://docs.coveo.com/en/1917/)).

[cols="3",options="header"]
|===
|Action
|Service - Domain
|Required access level

|View dashboards
|Analytics - Analytics data  
Analytics - Dimensions  
Analytics - Reports  
Organization - Organization
|View

.3+|Edit dashboards
|Analytics - Analytics data  
Analytics - Dimensions  
Organization - Organization
|View

|Analytics - Reports
|Edit

|Analytics - Administrate
|Allowed
|===