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

# Metrics catalog

> Browse and explore your metrics in the catalog, and map how they relate with Saved Trees

## Getting Started

The Metrics page uses your existing [Lightdash semantic layer](/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](/explore/metrics-catalog/build-saved-trees) by connecting metrics with edges, or let [drivers](/explore/metrics-catalog/drivers) defined in your `.yml` draw the relationships automatically.

## 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`](/semantic-layer/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](/explore/metrics-catalog/curate-the-catalog#curating-metrics-catalog-for-your-business-users))

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