Skip to content

Packages.yml page #8433

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
nataliefiann wants to merge 5 commits into
base: current
Choose a base branch
from
Open

Packages.yml page #8433

nataliefiann wants to merge 5 commits into from

Conversation

@nataliefiann
Copy link
Contributor

@nataliefiann nataliefiann commented Jan 15, 2026 •
edited by github-actions bot
Loading

What are you changing in this pull request and why?

Closes #5863

I have created this PR following the issue to

Things I've done:

  • updated the snippet: snippets/_packages_or_dependencies.md to link out to YAML tips page
  • Created a new page documenting the available context methods and variables in the packages.yml
  • Updated the description in the sidebar.js for the dbt Jinja functions and context variables page to include info that dependencies.yml doesn't support jina

Checklist

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

@nataliefiann nataliefiann requested a review from a team as a code owner January 15, 2026 12:05
@vercel
Copy link

vercel bot commented Jan 15, 2026 •
edited
Loading

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 1:50pm

Review with Vercel Agent

@github-actions github-actions bot added the content Improvements or additions to content label Jan 15, 2026
mirnawong1
mirnawong1 reviewed Jan 15, 2026
View reviewed changes
mirnawong1
mirnawong1 reviewed Jan 16, 2026
View reviewed changes
website/docs/reference/dbt-jinja-functions/packages.yml.md
- Use `env_var()` in any dbt YAML file that supports Jinja. Only `packages.yml` and `profiles.yml` support environment variables for [secure values](/docs/build/dbt-tips#yaml-tips) (using the `DBT_ENV_SECRET_` prefix).
- [var](/reference/dbt-jinja-functions/var) (Note: only variables defined with `--vars` are available. Refer to [YAML tips](/docs/build/dbt-tips#yaml-tips) for more information)

**Available context variables:**
Copy link
Contributor

@mirnawong1 mirnawong1 Jan 16, 2026

Choose a reason for hiding this comment

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

great examples @nataliefiann - do you think we should add the env_var one without the macro? it's the simplest one that is quite useful. the example you added in your docs plan i mean

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

Reviewers

@mirnawong1 mirnawong1 mirnawong1 left review comments

At least 1 approving review is required to merge this pull request.

Assignees

No one assigned

Labels

content Improvements or additions to content

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

[Core] New pages to explain context methods and variables available in packages.yml and dependencies.yml

3 participants

@nataliefiann @mirnawong1