analysis-paths

dbt_project.yml

analysis-paths: [directorypath]

Definition

Specify a custom list of directories where analyses are located.

Default

Without specifying this config, dbt will not compile any .sql files as analyses.

However, the dbt init command populates this value as analyses (source).

Paths specified in analysis-paths must be relative to the location of your dbt_project.yml file. Avoid using absolute paths like /Users/username/project/analyses, as they may lead to unexpected behavior.

• ✅ Do:

  # Recommended relative path example
  analysis-paths: ["analyses"]

• ❌ Don't:

  # Avoid using absolute paths
  analysis-paths: ["/Users/username/project/analyses"]

Examples

Use a subdirectory named analyses

This is the value populated by the dbt init command.

dbt_project.yml

analysis-paths: ["analyses"]

Use a subdirectory named custom_analyses

dbt_project.yml

analysis-paths: ["custom_analyses"]