Reveals
A reveal is a curated view of a domain. It pre-selects the most useful fields, suggests metrics, and sets the context for a query. Every Discover query starts from a reveal.
Selecting a reveal
The reveal picker (top-left of Discover) shows all reveals your workspace has access to, grouped by domain. Type to search.
What a reveal provides
- Field list — all attributes and metrics from the reveal's nodes, shown in the left panel
- Suggested metrics — pre-checked metrics (shown with ✓) when you open the reveal
- Context — the join graph is pre-configured so you don't need to think about SQL joins
Reveal vs. raw table
| Reveal | Raw SQL | |
|---|---|---|
| Joins | Pre-configured | Manual |
| Field names | Human-readable | Column names |
| Metrics | Pre-defined (SUM, AVG, etc.) | Manual aggregation |
| Governance | Centralised in Forge | Per-query |
Creating reveals
Reveals are defined in domain CML. See Forge → Domains → for the syntax.