Skip to main content

​
Getting Started

The Metrics page uses your existing 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 defined in your .yml draw the relationships automatically.

Catalog

Browse, explore, and curate your metrics in the Metrics Catalog.

Saved Trees

Map metric relationships and hierarchies in shareable tree diagrams.

Drivers

Define metric relationships in YAML and visualize them 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 (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)
Whenever you see spotlight in YAML, it’s configuring something on this page.