> ## 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.

<img src="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" alt="Catalog Metadata tab showing the Usage column with usage indicators and a tooltip with percentile, date range, query count, and unique users" width="1024" height="630" data-path="pics/cloud/catalog/table-usage-metadata-column.png" />

### 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.

## AI agents

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

<img src="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" alt="AI assistant response with a ranked list of the most queried tables" width="1024" height="765" data-path="pics/cloud/catalog/table-usage-ai-agent-report.png" />

## Related

* [Data Catalog](/cloud/features/collaboration-and-communication/catalog) — Overview of catalog navigation, metadata editing, and collaboration workflows.
* [AI agents](/cloud/ai-agents/overview) — How Elementary’s agents use catalog and observability context.
