---
title: Dimensions
slug: '1904'
canonical_url: https://docs.coveo.com/en/1904/
collection: coveo-analytics
source_format: adoc
---
# Dimensions
[Coveo Analytics dimensions](https://docs.coveo.com/en/258/) are [metadata](https://docs.coveo.com/en/218/) gathered by the [search interface](https://docs.coveo.com/en/2741/) and sent with the performed [events](https://docs.coveo.com/en/260/) to indicate the context of the recorded events.
You can use dimensions to better understand or filter [metrics](https://docs.coveo.com/en/263/).

When end users perform actions in a Coveo-powered interface (for example, search interfaces, case creation panels, web pages), events are logged.
Events come with a set of [metadata](https://docs.coveo.com/en/218/) (default or custom) that describe the context of an end-user action.
These events and their related metadata are sent to the Coveo Analytics database.
To learn more about events, see [Events](https://docs.coveo.com/en/2949/).

Each event metadata must be associated with a dimension to be available and leveraged in Coveo Analytics reports.
[Coveo organizations](https://docs.coveo.com/en/185/) come with a [set of dimensions](#standard-dimensions) already associated with most standard metadata but [user-defined dimensions](#user-defined-dimensions) can also be implemented to better scope the search solution to a specific context.

## Standard dimensions

Coveo-powered search interfaces, such as those built with the [Coveo JavaScript Search Framework](https://docs.coveo.com/en/187/), automatically log standard events and metadata.
Dimensions associated to the most standard metadata are available out-of-the-box in your Coveo organization, so that you can use them in reports.
For a list of standard dimensions, see [Standard dimensions reference](https://docs.coveo.com/en/2948/).

> **Note**
>
> Some logged event metadata isn't associated with dimensions out-of-the-box (see [Custom metadata reference](https://docs.coveo.com/en/pb6e0011/)).

**Example**

The **Country** dimension indicates from which country the end user performed a page visit, allowing you to show or filter events based on their geographic origin.

In your reports, you can find the number of visits per country in a [card](https://docs.coveo.com/en/267/).

![Bar chart showing visits per country | Coveo](https://docs.coveo.com/en/assets/images/coveo-platform/report-card-with-visits-per-country.png)

## User-defined dimensions

You can also create your own dimensions to better organize the events metadata according to your context.
You can benefit from these custom dimensions in reports once they're associated with the targeted events (see [Manage dimensions on custom metadata](https://docs.coveo.com/en/1522/)).

**Example**

To track the most consulted items for each team having access to your company's intranet (for example, R&D, Finance, HR, etc.), you define the `team` dimension.

Mark, a member of the HR team, searched for the company's benefits document.
When he clicked the result, a click event was logged with `HR` being sent as metadata in the custom `team` dimension.

The `team` dimension now allows you to report on the most clicked items for each team in a [table card](https://docs.coveo.com/en/1540/).