Standard and user-defined dimensions

Coveo Usage Analytics (Coveo UA) dimensions provide context for end-user actions in reports.

When end users perform actions in a Coveo-powered interface (e.g., search interfaces, case creation panels, web pages), Coveo usage analytics events are logged (see Usage analytics events). UA events come with a set of metadata (default or custom) that describes the context of an end-user action. These events and their related metadata are sent to the Coveo UA database.

Each event metadata must be associated with a dimension to be available and leveraged in UA reports. Coveo organizations come with a set of dimensions already associated with most standard metadata but user-defined dimensions can also be implemented to better scope the search solution to a specific context.

Standard Usage Analytics Event Dimensions

Coveo-powered search interfaces, such as those built with the Coveo JavaScript Search Framework, automatically log standard UA 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 UA reports (see Usage analytics dimensions).


Some logged event metadata aren’t associated with dimensions out-of-the-box (see Custom Metadata Reference).


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.


User-defined usage analytics dimensions

You can also create your own UA dimensions to better organize the UA events metadata according to your context. You can benefit from these custom dimensions in reports once they’re associated with the targeted UA events (see Manage dimensions on custom metadata).


To track the most consulted items for each team having access to your company’s intranet (e.g., 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 on 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.