Skip to content

Conversation

@mirnawong1
Copy link
Contributor

What are you changing in this pull request and why?

This PR updates the documentation for profiles.yml precedence on both the profiles.yml and connection-profiles pages.

The changes clarify the different precedence orders for profiles.yml location between dbt Core and dbt Fusion. Specifically, it highlights that the DBT_PROFILES_DIR environment variable is only supported in dbt Core and not in dbt Fusion.

This addresses user confusion regarding profiles.yml resolution in Fusion environments, as discussed in this Slack thread.

Checklist


Slack Thread

Open in Cursor Open in Web

- Update _profiles.yml.md to show precedence order with tabs for Core vs Fusion
- Update _connection-profiles.md to clarify differences in profile directory precedence
- Add note that DBT_PROFILES_DIR is only supported in dbt Core, not Fusion
- Clarify that Fusion uses a simplified precedence without DBT_PROFILES_DIR env var

Co-authored-by: mirna.wong <[email protected]>
@cursor
Copy link

cursor bot commented Jan 16, 2026

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
Learn more about Cursor Agents

@vercel
Copy link

vercel bot commented Jan 16, 2026

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

Project Deployment Review Updated (UTC)
docs-getdbt-com Ready Ready Preview Jan 16, 2026 4:36pm

Request Review

@github-actions github-actions bot added content Improvements or additions to content Docs team Authored by the Docs team @dbt Labs labels Jan 16, 2026
dbt Fusion determines the parent directory for `profiles.yml` using the following precedence:

1. `--profiles-dir` option
2. current working directory
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

edit

dbt Fusion searches for the parent directory of `profiles.yml` in the following order and uses the first location it finds:

1. `--profiles-dir` flag &mdash; Override for CI/CD or testing.
2. Project root directory (current working directory) &mdash; Project-specific credentials.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

edit this

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content Improvements or additions to content Docs team Authored by the Docs team @dbt Labs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants