Skip to content

Setting project-wide configuration in dbt_project.yml

The dbt_project.yml file lets you define default configurations for models, seeds, snapshots, and other resources at the project, directory, or subdirectory level, avoiding the need to repeat config() blocks in every model. Configurations set here apply hierarchically based on file path, and can be overridden by more specific configs in individual model files or in yml property files.

Must-know

  • Configurations in dbt_project.yml are nested under resource type keys (e.g., models:, seeds:, snapshots:) followed by the project name and then folder paths matching your file structure.
  • The precedence order from lowest to highest is: dbt_project.yml defaults, then config() in the model/seed/snapshot file itself, then config defined in a schema.yml or properties file, with the most specific/local config always winning.
  • Common configs set here include materialized, schema, tags, enabled, persist_docs, and grants, which can be applied broadly to a folder or narrowed to subfolders.
  • Setting materialized: view or table at the top project level creates a default that individual folders (e.g., staging vs. marts) can override with more specific materializations like incremental or ephemeral.
  • A common gotcha is indentation errors or mismatched folder paths in the yml hierarchy, which silently cause configs not to apply as expected since dbt won't always error loudly.
  • The +config-key: value syntax (with a leading plus sign) is required for resource configs in dbt_project.yml to distinguish them from folder path keys, especially in dbt version 0.17+.
Check this objectiveFree · always available

Your dbt_project.yml contains: models: my_project: staging: +materialized: view The model file models/staging/stg_orders.sql begins with: {{ config(materialized='table') }} select ... When you run dbt run, how is stg_orders materialized?

Your objective map0 tried · 0 right · 31 untouched

What you have tried across dbt Analytics Engineering's objectives, not a readiness score.

Coverage checked against the published exam guide on Aug 4, 2026.

These are independent practice questions, written against this certification's published exam guide. They are not the certification vendor's own questions, and not the real exam.