> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elementary-data.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Table usage

Table usage shows how your data assets are **actually consumed** in the warehouse—how often they are queried and by who—based on **query activity** over a **rolling 30-day window**. That visibility helps you **prioritize incidents and data quality** on the assets that drive the most load and downstream impact, and get a **clearer end-to-end view** of what is happening in production.

## Usage in the Catalog

Open the **Catalog** and select the **Metadata** tab. Table assets include a **Usage** column with a **usage indicator** so you can compare relative activity at a glance.

![Catalog Metadata tab showing the Usage column with usage indicators and a tooltip with percentile, date range, query count, and unique users](https://mintcdn.com/elementary/eF_Xkir0rQ7qJwpY/pics/cloud/catalog/table-usage-metadata-column.png?fit=max\&auto=format\&n=eF_Xkir0rQ7qJwpY\&q=85\&s=add18152ad9bc55a84d8c995fe44ee60)

### Tooltip details

Hover the usage indicator for a specific asset to open a tooltip with:

* **Percentile rank** — How this table’s query volume ranks against every other table. For example, **72nd percentile** means its query volume is **greater than or equal to** that of **72% of tables** in your environment.
* **Reporting period** — The exact **30-day** date range the metrics are based on (for example, March 15 – April 14, 2026).
* **Query count** — Total queries against the table in that period.
* **Unique users** — Distinct users who ran queries against the table in that period.

## Elementary AI Agent

The same usage signals are available to the **Elementary AI Agent**, so you can ask natural-language questions that depend on real consumption—for example, **“Show me the top 5 most used tables.”**

![AI assistant response with a ranked list of the most queried tables](https://mintcdn.com/elementary/eF_Xkir0rQ7qJwpY/pics/cloud/catalog/table-usage-ai-agent-report.png?fit=max\&auto=format\&n=eF_Xkir0rQ7qJwpY\&q=85\&s=a257e85d10551753009ae12c5fed9898)

## Related

* [Data Catalog](https://docs.elementary-data.com/cloud/features/collaboration-and-communication/catalog.md) — Overview of catalog navigation, metadata editing, and collaboration workflows.
* [Elementary AI Agent](https://docs.elementary-data.com/cloud/ai-agents/overview.md) — How the agent uses catalog and observability data.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.