Skip to main content




Exposures make it possible to define and describe a downstream use of your dbt project, such as in a dashboard, application, or data science pipeline. By defining exposures, you can then:

  • run, test, and list resources that feed into your exposure
  • populate a dedicated page in the auto-generated documentation site with context relevant to data consumers

Declaring an exposure

Exposures are defined in .yml files nested under an exposures: key.

version: 2


- name: weekly_jaffle_metrics
type: dashboard
maturity: high
url: https://bi.tool/dashboards/1
description: >
Did someone say "exponential growth"?

- ref('fct_orders')
- ref('dim_customers')
- source('gsheets', 'goals')

name: Claire from Data

Available properties


  • name (must be unique among exposures and you must use the snake case naming convention)
  • type: one of dashboard, notebook, analysis, ml, application (used to organize in docs site)
  • owner: email


  • depends_on: list of refable nodes (ref + source)


  • url: enables the link to View this exposure in the upper right corner of the generated documentation site
  • maturity: one of high, medium, low
  • owner: name

General properties (optional)

  • description
  • tags
  • meta

We plan to add more subtypes and optional properties in future releases.

Referencing exposures

Once an exposure is defined, you can run commands that reference it:

dbt run -s +exposure:weekly_jaffle_metrics
dbt test -s +exposure:weekly_jaffle_metrics

When we generate our documentation site, you'll see the exposure appear:

Dedicated page in dbt-docs for each exposure

Dedicated page in dbt-docs for each exposure

Exposures appear as orange-y nodes in the DAG

Exposures appear as orange-y nodes in the DAG