About Usage Analytics Limits

This topic 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 of the usage analytics licensing limits you agreed upon when signing the Coveo Customer Agreement are displayed in the Coveo Cloud administration console Settings page/panel.

To access the Settings page/panel, click the Settings (Icon-AC8_Settings) icon in the upper right corner, and the select the Analytics tab (see Analytics Tab).

In the Settings page/panel, the displayed limits are the following:

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