About Usage Analytics Limits

This article lists the usage analytics limits inside the Coveo Cloud platform that either come from the platform itself or your license. Contact Coveo when you want to extend your license limits.

Some usage analytics licensing limits you agreed upon when signing the Coveo Customer Agreement are displayed in the Coveo Cloud administration console Settings panel, under Analytics, in the Limits sub tab (see Accessing and Navigating the “Settings” Panel).

In the Settings panel, the Analytics limits are the following:

Exports: Limit on the number of usage analytics Data Exports that members of your Coveo Cloud organization can create (see Adding and Managing Data Exports).
Export schedules: Limit on the number of export Schedules that members of your Coveo Cloud organization can create (see Adding and Managing Data Exports).
Custom dimensions: Limit on the number of user-defined Dimensions that members of your Coveo Cloud organization can create (see Usage Analytics Dimensions and Adding Dimension and Metric Filters in Usage Analytics Cards).
Reports: Limit on the number of usage analytics Reports that members of your Coveo Cloud organization can create (see Usage Analytics Reports and Adding and Managing Usage Analytics Reports).
Named filters: Limit on the number of Named Filters members of your Coveo Cloud organization can create (see Adding and Managing Named Filters).
Permission filters: Limit on the number of Permission Filters that members of your Coveo Cloud organization can create (see Adding and Managing Permission Filters).

The following additional limits also apply:

Limit	Value
Maximum number of custom dimensions	By default 25 all types included
Maximum number of values per dimension filter	Advanced query expression: 5 Keyword: 250 All other dimensions: 75
Maximum number of characters for every dimension value	See Dimension Value Limits
Maximum size of analytics data exports	1 million+ rows (a warning is issued)
Maximum number of analytics data exports	Depends on the license By default 25.

Dimensions and the Maximum Length of Their Logged Values

Each dimension (custom and out-of-the-box) has its own column in the database. Each column can only contain values of a certain type and a certain length depending on the dimension. The following table displays the column name and the DB data type as well as the limit of characters the column can contain when applicable (see Data types and SQL General Data Types).

When you send blocks of text through a custom dimension (text), the database only keeps the first 256 characters.

Column name	DB data type (Limit of characters)
`account_id`	varchar(128)
`advanced_query_expression`	varchar(2048)
`batch_id`	char(36)
`cause`	varchar(64)
`cause2`	varchar(64)
`custom_datas`	varchar(32500)
[`custom_dimension_(boolean)_name`]	boolean
[`custom_dimension_(datetime)_name`]	timestamp
[`custom_dimension_(number)_name`]	float8
[`custom_dimension_(text)_name`]	varchar(256)
`datetime`	timestamp
`device_category`	varchar(128)
`document_author`	varchar(128)
`document_category`	varchar(128)
`document_title`	varchar(128)
`event_outcome`	integer
`is_anonymous`	boolean
`is_contextual`	boolean
`is_internal`	boolean
`number_of_results`	integer
`operating_system`	varchar(128)
`operating_system_with_version`	varchar(128)
`origin_device`	varchar(256)
`origin_city`	varchar(256)
`origin_context`	varchar(128)
`origin_country`	varchar(256)
`origin_is_mobile`	boolean
`origin_language`	varchar(256)
`origin_level_1`	varchar(128)
`origin_level_2`	varchar(128)
`origin_level_3`	varchar(128)
`origin_region`	varchar(256)
`query_expression`	varchar(500)
`query_pipeline`	varchar(128)
`response_time_ms`	integer
`search_id`	char(36)
`split_test_run_name`	varchar(128)
`split_test_run_version`	varchar(128)
`unique_user_id`	varchar(128)
`user_agent`	varchar(1024)
`user_id`	varchar(128)
`user_ip`	varchar(50)
`user_name`	varchar(128)
`visit_id`	char(36)
`visitor_id`	varchar(128)
`web_browser`	varchar(128)
`web_browser_with_version`	varchar(128)
`with_clicks`	boolean
`with_results`	boolean