YAML and SQL config block changes

[runleonarun]

Closes https://dbtlabs.atlassian.net/browse/PRODDOCS-26

What are you changing in this pull request and why?

Making these consistent in the docs:

• Config block or SQL config or SQL file config
• dbt_project.yml or Project file
• Property file/Property YAML/ YAML file

Checklist

• The changes in this PR meet the docs style guide/fundamentals required for all content.
• Applied the proper versioning rules if the content is for specific dbt version(s): (version a whole page or version a block of content
• The content in this PR requires a dbt release note, so I added one to the release notes page.).

---

🚀 Deployment available! Here are the direct links to the updated files:

• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/best-practices/materializations/materializations-guide-4-incremental-models
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/best-practices/materializations/materializations-guide-5-best-practices
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/docs/build/custom-schemas
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/docs/build/incremental-models
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/docs/build/metricflow-time-spine
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/docs/build/packages
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/docs/build/projects
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/docs/build/python-models
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/docs/build/snapshots
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/docs/build/udfs
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/docs/dbt-versions/core-upgrade/05-upgrading-to-v1.10
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/docs/dbt-versions/core-upgrade/08-upgrading-to-v1.7
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/docs/deploy/state-aware-setup
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/docs/mesh/iceberg/databricks-iceberg-support
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/docs/mesh/iceberg/snowflake-iceberg-support
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/faqs/Project/properties-not-in-config
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/guides/dbt-python-snowpark
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/guides/mesh-qs
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/guides/sl-snowflake-qs
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/guides/teradata-qs
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/advanced-config-usage
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/data-test-configs
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/global-configs/behavior-changes
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/model-configs
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/alias
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/batch_size
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/begin
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/bigquery-configs
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/clickhouse-configs
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/databricks-configs
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/deltastream-configs
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/doris-configs
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/enabled
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/event-time
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/firebolt-configs
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/freshness
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/grants
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/lookback
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/materialized
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/meta
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/on_configuration_change
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/postgres-configs
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/pre-hook-post-hook
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/redshift-configs
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/schema
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/snapshots-jinja-legacy
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/snowflake-configs
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/sql_header
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/starrocks-configs
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/static-analysis
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/tags
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/target_database
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-configs/teradata-configs
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/resource-properties/concurrent_batches
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/snapshot-configs
• https://docs-getdbt-com-git-make-tabs-consistent-dbt-labs.vercel.app/reference/source-configs

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Updated (UTC)
docs-getdbt-com	Ready	Preview	Nov 10, 2025 10:52am

[mirnawong1]

hey @runleonarun , really great intent and improvements! some small suggestions based on my understanding:

• recommend using 'properties YAML file' instead of property file. this is because
  • it makes it clear that the file is a YAML file (consistent with the SQL file config naming)
  • using properties plural because there can be multiple properties and matches what we say in docs
• Likewise, i suggest specifying project YAML file
• SQL file config makes sense but because we use 'config' so often and its ingrained - i'd recommend 'SQL file config block' but thats too long! - so maybe when we're writing explanatory text, we should try to use “config block” naturally in the sentence.