Usage Analytics Limits

This article lists the usage analytics limits inside the Coveo Platform 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 25 Number of usage analytics data exports that members of your Coveo organization can create (see Manage Data Exports).
Export schedules 25 Number of data export schedules that members of your Coveo organization can create (see Manage Data Exports).
Custom dimensions 25 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 500 Number of usage analytics reports that members of your Coveo organization can create (see Usage Analytics Reports and Manage Usage Analytics Reports).
Named filters 400 Number of named filters that members of your Coveo organization can create (see Manage Named Filters).
Permission filters 100 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 300,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 P3Y (3 years) Number of months or years of usage analytics data that members of your Coveo organization can visualize.

Note 1: Limit values for a Coveo Cloud Standard license. This limit can be increased if we believe that it’s for reasonable usage.

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

  • By default 25.

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
Recommended Articles