> ## Documentation Index
> Fetch the complete documentation index at: https://lightdash-mintlify-cccf65ca.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Metrics

> The Metrics page puts your metrics front and center. Browse and explore them in the Metrics Catalog, and map how they relate to each other with Saved Trees.

## Getting Started

The Metrics page uses your existing [Lightdash semantic layer](/guides/lightdash-semantic-layer) and metrics definitions, so you can get started today. Head to **Metrics** in the navigation bar to start exploring.

The Metrics page has two views, switched with the toggle in the top-right corner:

* **Catalog** — A searchable, filterable table of all your project metrics. Browse metrics by category, owner, or popularity, explore any metric over time in the Metrics Explorer, and curate what your business users see through `.yml` configuration.

* **Saved Trees** — Shareable diagrams of how your metrics relate to each other. Build them on a canvas by connecting metrics with edges, or let [drivers](/guides/metrics-catalog/drivers) defined in your `.yml` draw the relationships automatically.

<CardGroup cols={3}>
  <Card title="Catalog" icon="list" href="/guides/metrics-catalog/catalog">
    Browse, explore, and curate your metrics in the Metrics Catalog.
  </Card>

  <Card title="Saved Trees" icon="sitemap" href="/guides/metrics-catalog/saved-trees">
    Map metric relationships and hierarchies in shareable tree diagrams.
  </Card>

  <Card title="Drivers" icon="arrow-trend-up" href="/guides/metrics-catalog/drivers">
    Define metric relationships in YAML and visualize them automatically.
  </Card>
</CardGroup>

## The `spotlight` config

`spotlight` is the YAML namespace that covers everything about how your metrics show up across the Metrics experience — visibility in the catalog (`visibility`), grouping (`categories`), ownership (`owner`), and explorer behavior like default time dimensions, filters, and segments. It works at two levels:

* **Project level** — defaults for the whole project, set in [`lightdash.config.yml`](/references/lightdash-config-yml#metrics-catalog-configuration) (e.g. `default_visibility`, available `categories`)
* **Metric/model level** — per-metric overrides, set under `meta.spotlight` in your dbt model `.yml` (see [curating the catalog](/guides/metrics-catalog/catalog#curating-metrics-catalog-for-your-business-users))

Whenever you see `spotlight` in YAML, it's configuring something on this page.