Usage Analytics Limits

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

Resource Limits

Some usage analytics licensing limits you agreed upon when signing the Coveo Customer Agreement are displayed in the Coveo Administration Console Settings panel, under Analytics, in the Limits subtab. The Analytics limits are the following:

Limit Default value1 Definition
Exports 0 Number of usage analytics data exports that members of your Coveo organization can create (see Manage Data Exports).
Export schedules 0 Number of data export schedules that members of your Coveo organization can create (see Add a Schedule for Exports).
Custom dimensions 10 Number of user-defined dimensions that members of your Coveo organization can create (see Usage Analytics Dimensions and Add Dimension and Metric Filters in Usage Analytics Cards).
Reports 4 Number of usage analytics reports that members of your Coveo organization can create (see Usage Analytics Reports and Manage Usage Analytics Reports).
Named filters 0 Number of named filters that members of your Coveo organization can create (see Manage Named Filters).
Permission filters 0 Number of permission filters that members of your Coveo organization can create (see Manage Permission Filters).
Daily events 10,000,000 Number of usage analytics events that can be pushed to your Coveo organization per day.
Monthly events 10,000,000 Number of usage analytics events that can be pushed to your Coveo organization per month.
Queries per hour 3,000 Maximum number of queries that can be sent to the usage analytics database from your Coveo organization. Loading reports and cards triggers those queries.
Retention period P6M (6 months) Number of months or years of usage analytics data that members of your Coveo organization can visualize.
  1. Limit values for a Coveo Base license. You need to upgrade to the Pro or Enterprise Platform plan to increase limits.

Other Limits

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 (applies also to named and permission filters)1
  • 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 None2
Maximum number of analytics data exports
  • Depends on the license

  • 25 (default).

Maximum amount of time for queries to execute on a report

Two minutes

For information on how to improve report loading time, see Usage Analytics Reporting Leading Practices

1: Any combination of filters on the same dimension, including named and permission filters, can’t exceed 75 values as well.

2: It’s however strongly recommended to keep exports below 1 million rows for performance reasons. A warning is issued if your export exceeds that size. To avoid that, you can split your annual export into smaller exports (e.g., one per quarter).

Dimensions and the Maximum Length of Their Logged Values

Each dimension (custom and default) 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_levelv3 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
What's Next for Me?