Review your license and usage
Review your license and usage
The License & Usage (platform-ca | platform-eu | platform-au) page gives you a clear view of your Coveo license and its metrics. You can use it to review the products and features included in your plan and track how your current usage aligns with your entitlements.
The page also offers insights into your usage trends over time, helping you monitor and make informed adjustments to maintain optimal performance for your users. For example, if you notice a sudden increase in the number of items in your index, you can investigate its source and take steps to reduce your item count. Similarly, if you notice that you’re regularly nearing your entitled usage level, you may consider contacting your Coveo representative to discuss increasing your entitlement or optimizing your usage.
As explained under Concepts, exceeding an entitlement may result in certain activities in your Coveo organization being throttled or blocked. Regularly monitoring your usage helps you take proactive steps to prevent service disruptions and maintain consistent performance.
Concepts
Understanding the following concepts will help you interpret the information presented on the License & Usage (platform-ca | platform-eu | platform-au) page.
A quota is a usage threshold set by Coveo to ensure platform performance and fair use. If your usage exceeds a quota, certain activities may be throttled or blocked, depending on the quota.
|
Note
The License & Usage page is evolving and doesn’t display your quotas yet. Keep an eye on our new features page to stay informed when this information becomes available. |
Some quotas can be increased upon request. If you’re regularly close to your usage quota, reach out to your Coveo representative to discuss possible adjustments.
An entitlement is a usage allowance defined in your Coveo contract. While entitlements are a type of quota, not all quotas are entitlements. If your usage exceeds an entitlement, certain activities may be throttled or blocked, and a Coveo representative may reach out if overuse persists.
A limit is a maximum usage level that can’t be exceeded without impacting platform performance and stability. Limits apply to all Coveo customers and can’t be increased. If your usage reaches a limit, Coveo blocks or throttles further activity, depending on the limit. The License & Usage page doesn’t display Coveo’s limits.
Overview
1 |
The License section displays the products, add-ons, integrations, and other features included in your Coveo license. It also shows the expiration dates for your license and products. |
2 |
The Entitlements section displays the usage allowances defined in your Coveo contract, such as the number of items in your index or the number of queries your search interface users can perform each month.
It also shows your current usage.
Click |
About your entitlements
The following sections explain the entitlements that you can find on the License & Usage (platform-ca | platform-eu | platform-au) page, along with what counts toward them and tips to optimize your usage, where applicable.
Not all of the following entitlements may apply to your organization, depending on the products and features included in your license. Refer to your License & Usage page to see which entitlements are relevant to your organization.
Item count optimization
The number of items in your index is a key entitlement of your Coveo license. Monitoring and optimizing your item count can help you stay within your entitlement. To do so, consider the following best practices:
-
Delete unused sources. Do you have test or duplicate sources that are no longer needed? Consider using non-production organizations and resource snapshots for testing purposes.
-
Check the Content Browser (platform-ca | platform-eu | platform-au) for unwanted items. Are there indexed items that provide no value? Are some items indexed multiple times?
-
Check your analytics Reports (platform-ca | platform-eu | platform-au). Are there items that receive no traffic and that could be removed from your index?
-
Review each source’s options and inclusion/exclusion filters. Consider adding or refining source filters to better control what is indexed.
You can review your item entitlement on the License & Usage (platform-ca | platform-eu | platform-au) page, along with your current usage.
Queries per month
Your queries per month (QPM) entitlement is the total number of requests your organization can make to Coveo’s Search API each month. See About queries for details on what counts as a query.
For troubleshooting purposes, you can access query data for each search hub, including the total number of queries and a list of executed queries, through the Consumption (platform-ca | platform-eu | platform-au) dashboard. See Access a resource consumption graph and Access query logs for more details.
You can review your queries per month (QPM) entitlement on the License & Usage (platform-ca | platform-eu | platform-au) page, along with your current usage.
Generative queries per month
Generative queries are user queries that are sent to a Coveo RGA model or a Coveo Search Agent to generate an answer.
The following scenarios trigger a generative query that counts toward your entitlement:
-
A search interface user performs a search that is sent to a Coveo RGA model or a Coveo Search Agent. This counts toward your generative queries per month (GQPM) entitlement whether or not an answer is generated.
-
A search interface user applies filters (for example, facet values) to a search that already generated an answer. This triggers a new request to update the answer based on the applied filters.
If your RGA-enabled search interface is associated with an answer configuration in the Answer Manager, ensure that duplicate generative queries are avoided by adding the answerAPI condition to your query pipeline’s RGA model association.
You can review your generative queries per month (GQPM) entitlement on the License & Usage (platform-ca | platform-eu | platform-au) page, along with your current usage.
Passage queries per month
Your passage queries per month (PQPM) entitlement is the total number of requests your LLM applications can make to Coveo’s passage retrieval API each month. These requests can be triggered by user interactions, automated scripts, agents, and other processes. To learn more about this process, see Using CPR with the Passage Retrieval API.
You can review your passage queries per month (PQPM) entitlement on the License & Usage (platform-ca | platform-eu | platform-au) page, along with your current usage.
Recommendation queries per month
Your recommendation queries per month (RQPM) entitlement is the total number of queries used to display content recommendations each month.
Recommendation queries originate from search interfaces that use Coveo ML Content Recommendations (CR), Product Recommendations (PR), or IPX Recommendations (IPXRECS).
What counts as a recommendation query, however, varies by ML feature:
-
CR and PR: Each time recommendations are returned by the model, it counts toward your recommendation queries per month (RQPM) entitlement.
-
IPXRECS: Like CR and PR, receiving IPX recommendations also counts toward your RQPM entitlement. One recommendation query is consumed each time a list of IPX recommendations is generated, which occurs whenever the IPX search interface loads.
However, submitting a search request in an IPX search interface is considered a standard query, which counts against your queries per month (QPM) entitlement.
You can review your recommendation queries per month (RQPM) entitlement on the License & Usage (platform-ca | platform-eu | platform-au) page, along with your current usage.
Agents per 3 months
Agents are autonomous entities that can perform various tasks, such as sending messages, creating cases, or executing scripts. Your agents per month entitlement is the total number of agents that can access your Coveo search interfaces each month to perform queries and receive results, recommendations, or generated answers.
You can review your agents per month entitlement on the License & Usage (platform-ca | platform-eu | platform-au) page, along with your current usage.
Required privileges
The following table lists the privileges required to access the License & Usage (platform-ca | platform-eu | platform-au) page and its subpages. See Manage privileges for more information on granting privileges, and the Privilege reference for details on each privilege.
| Action | Service - Domain | Required access level |
|---|---|---|
View the License & Usage page |
Organization - Organization |
View |
Very useful
Not really
Very useful
Not really