Skip to main content

dbt artifacts viewer

The dbt artifacts viewer in dbt-Workbench reads your dbt artifacts so lineage, runs, catalog metadata, and docs previews stay in sync. Keep artifacts current to ensure the UI reflects the latest project state.

Required artifacts​

Mount the following files into the DBT_ARTIFACTS_PATH directory:

  • manifest.json
  • run_results.json
  • catalog.json

Docs assets​

If you run dbt docs generate, include the generated index.html and assets alongside the artifacts. dbt-Workbench will host the docs viewer directly from these files.

How artifacts are used​

ArtifactUsed for
manifest.jsonModel lineage, compiled SQL, dependencies
run_results.jsonRun history, statuses, and logs
catalog.jsonCatalog metadata, column statistics, freshness
Docs assetsdbt docs viewer UI