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

You can, among other things, add calculated metric cards to dashboards to review the importance of a [metric](https://docs.coveo.com/en/263/) value in your organization.
For example, you can use a calculated metric card to measure the ratio of visits on your customer support website with at least one user query to the total number of visits.

## Add calculated metric 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.

. Create the [**Metric**](https://docs.coveo.com/en/2040/) or [**Visit Metric**](https://docs.coveo.com/en/1563/) cards that you want to use in the calculation, if not already done.

**Example**

You want to know the ratio of clicks made daily by New York users compared to the total click event count so you create the two following metric cards.

![Two metric cards showing Daily Click Count | Coveo](https://docs.coveo.com/en/assets/images/coveo-analytics/metric-cards-with-click-count.png)

> **Note**
>
> Since calculated metric cards use either two existing metric card values or a number and a metric card value in their calculations, a metric card is required in the dashboard tab in which you want to add a calculated metric card.

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

> **Note**
>
> You can also click [copy16px] to [duplicate](https://docs.coveo.com/en/1804/) an existing card, and then only modify what's required.

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

.. Select **Calculated metric**.

**Examples**

* You can multiply the number of cases deflected by the average cost to resolve a case.

* You can divide the number of clicks in a city by the total click event count.

![Metric card showing ratio of clicks to total clicks | Coveo](https://docs.coveo.com/en/assets/images/coveo-analytics/metric-card-with-click-ratio.png)

.. In the first input, enter a meaningful **Card title** (for example, `Ratio of Clicks in New-york to the Total Number of Clicks`).

> **Note**
>
> If you leave the input empty and save the dashboard, the card title will be **Calculated metric**.

.. [[step4c]]After clicking the **First metric card value or number** dropdown menu:

... Click the **Entry type** dropdown menu, and then select whether you want to use a **Metric card value** or a **Number** as your first equation variable.

... Depending on your **Entry Type** selection:

**** When you select **Metric card value**, click the **Metric card** dropdown menu, and then select one available metric card of the current report tab.

> **Note**
>
> A metric card can only be used in one calculated metric card.

**** When you select **Number**, in the **Number** box, enter a round number (other than 0) or a decimal.

.. Click **Apply**.

.. Click the **Operator** dropdown menu, and then select one equation operator between the available options:

*** **+ (addition)**

*** **- (subtraction)**

*** **÷ (division)**

*** **x (multiplication)**

.. In the **Second metric card value or number** dropdown menu, select or enter another equation variable as you did [previously](#step4c).

> **Note**
>
> You must select at least one metric card value as one equation variable.

.. Under **Value formatting**, choose how the card value is formatted by selecting one of the following options:

> **Notes**
>
> * By default, no formatting is applied to the calculated metric value.
> 
> * The rule used to format the card value `+{value}+` appears between parentheses following the option name.

*** **None** `+{value}+`

*** **Currency** `+${value}+`

*** **Percentage** `{100*value}%`

*** **Custom**

When selecting **Custom**, enter the **Rule** used to format the calculated metric value in the following form:

> **Note**
>
> Value must be placed between braces (`{}`), but parts between square brackets (`[]`) are optional (for example, `[s]{[n*]value[.n]}[s]`, where you replace `[s]` with any string, `[n]` by a number, and the second `[n]` specifies the number of decimals).
> 
> For example, you want to display the cost to manage a support case, so you enter the following rule:
> 
> `+${value}/case+`
> 
> In the report, the card value looks like the following:
> 
> ![Average Cost Per Support Case metric example | Coveo](:https://docs.coveo.com/en/assets/images/coveo-analytics/metric-card-average-cost-per-case.png)

.. Click **Add Card**.

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

When hovering over the card, you can see the calculation that's made to get this result.

![Calculated metric example showing ratio of clicks to total clicks | Coveo](https://docs.coveo.com/en/assets/images/coveo-analytics/metric-card-radio-of-total-clicks.png)

## 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
|===