Skip to content

Clarify template context for asset-triggered DAGs in airflow-core docs#61258

Merged
shahar1 merged 4 commits intoapache:mainfrom
rachanadutta:docs-asset-dag-template-context
Jan 31, 2026
Merged

Clarify template context for asset-triggered DAGs in airflow-core docs#61258
shahar1 merged 4 commits intoapache:mainfrom
rachanadutta:docs-asset-dag-template-context

Conversation

@rachanadutta
Copy link
Contributor

This PR updates the template context documentation to explicitly cover
asset-triggered DAGs in Airflow 3.

It clarifies the absence of time-based context variables such as logical_date
and ds for asset-triggered workflows, documents the correct format of
task_instance_key_str, and explains how dag_run.run_id can be used instead.

This helps prevent confusion and runtime errors when authoring templates for
asset-based workflows.

Closes #61149

@rachanadutta
Copy link
Contributor Author

@shahar1
I checked the previous discussion in #51741 and updated the documentation to remove
the claim about uniqueness for task_instance_key_str.

Copy link
Contributor

@shahar1 shahar1 left a comment

Choose a reason for hiding this comment

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

Well done!

@shahar1 shahar1 changed the title Docs: clarify template context for asset-triggered DAGs Clarify template context for asset-triggered DAGs in docs Jan 30, 2026
@shahar1 shahar1 changed the title Clarify template context for asset-triggered DAGs in docs Clarify template context for asset-triggered DAGs in airflow-core docs Jan 30, 2026
@shahar1 shahar1 merged commit f7aa502 into apache:main Jan 31, 2026
72 checks passed
@boring-cyborg
Copy link

boring-cyborg bot commented Jan 31, 2026

Awesome work, congrats on your first merged pull request! You are invited to check our Issue Tracker for additional contributions.

@shahar1 shahar1 added the backport-to-v3-1-test Mark PR with this label to backport to v3-1-test branch label Jan 31, 2026
shahar1 pushed a commit to shahar1/airflow that referenced this pull request Jan 31, 2026
apache#61258)

Co-authored-by: kevinhongzl <zhenlun.hong01@gmail.com>
(cherry picked from commit f7aa502)
shahar1 added a commit that referenced this pull request Jan 31, 2026
…low-core docs (#61258) (#61282)

(cherry picked from commit f7aa502)

Co-authored-by: Rachana Dutta <rupss2105@gmail.com>
Co-authored-by: kevinhongzl <zhenlun.hong01@gmail.com>
morelgeorge pushed a commit to morelgeorge/airflow that referenced this pull request Feb 1, 2026
shashbha14 pushed a commit to shashbha14/airflow that referenced this pull request Feb 2, 2026
apache#61258)

Co-authored-by: kevinhongzl <zhenlun.hong01@gmail.com>
ephraimbuddy pushed a commit that referenced this pull request Feb 3, 2026
…low-core docs (#61258) (#61282)

(cherry picked from commit f7aa502)

Co-authored-by: Rachana Dutta <rupss2105@gmail.com>
Co-authored-by: kevinhongzl <zhenlun.hong01@gmail.com>
potiuk pushed a commit that referenced this pull request Feb 3, 2026
* [v3-1-test] Add Keycloak token documentation to Security/API (#61228) (#61248)

(cherry picked from commit bb04b5d)

Co-authored-by: Bugra Ozturk <bugraoz93@users.noreply.github.com>

* [v3-1-test] Fix language selector state not updating on change (#61060) (#61263)

(cherry picked from commit 975cfe6)

* [v3-1-test] Clarify template context for asset-triggered DAGs in airflow-core docs (#61258) (#61282)

(cherry picked from commit f7aa502)

Co-authored-by: Rachana Dutta <rupss2105@gmail.com>
Co-authored-by: kevinhongzl <zhenlun.hong01@gmail.com>

* [v3-1-test] Fix flaky OTel integration test with DNS health check (#61070) (#61242) (#61286)

* Fix flaky OTel integration test with DNS health check (#61070)

* Update airflow-core/tests/integration/otel/test_otel.py



---------
(cherry picked from commit 8ac25dd)

Co-authored-by: Abhishek Mishra <mishra.abhishek2808@gmail.com>
Co-authored-by: Henry Chen <henryhenry0512@gmail.com>

* [v3-1-test] Update pmc verification docs (#61271) (#61294)

* Update Helm Chart release instructions for PMC Checks

* Update KEY download instructions for PMC Checks

* Update dev/README_RELEASE_HELM_CHART.md
(cherry picked from commit c74b24a)

* [v3-1-test] update version for release command (#61260) (#61328)

(cherry picked from commit 7790482)

Co-authored-by: Rahul Vats <43964496+vatsrahul1001@users.noreply.github.com>

* CI: Upgrade important CI environment (#61327)

* [v3-1-test] Fix JWT token generation with unset issuer/audience config (#61278) (#61331)

* Fix JWT token generation with unset issuer/audience config
(cherry picked from commit a440d1d)

Co-authored-by: Amogh Desai <amoghrajesh1999@gmail.com>

* [v3-1-test] Remove empty `apache_airflow_site.py` file (#61308)
(cherry picked from commit d65ff01)

Co-authored-by: Jed Cunningham <66968678+jedcunningham@users.noreply.github.com>

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Bugra Ozturk <bugraoz93@users.noreply.github.com>
Co-authored-by: Guan-Ming (Wesley) Chiu <105915352+guan404ming@users.noreply.github.com>
Co-authored-by: Shahar Epstein <60007259+shahar1@users.noreply.github.com>
Co-authored-by: Rachana Dutta <rupss2105@gmail.com>
Co-authored-by: kevinhongzl <zhenlun.hong01@gmail.com>
Co-authored-by: Abhishek Mishra <mishra.abhishek2808@gmail.com>
Co-authored-by: Henry Chen <henryhenry0512@gmail.com>
Co-authored-by: Rahul Vats <43964496+vatsrahul1001@users.noreply.github.com>
Co-authored-by: Amogh Desai <amoghrajesh1999@gmail.com>
Co-authored-by: Jed Cunningham <66968678+jedcunningham@users.noreply.github.com>
jason810496 pushed a commit to abhijeets25012-tech/airflow that referenced this pull request Feb 3, 2026
jhgoebbert pushed a commit to jhgoebbert/airflow_Owen-CH-Leung that referenced this pull request Feb 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport-to-v3-1-test Mark PR with this label to backport to v3-1-test branch kind:documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update template fields documentation to include more details about asset-triggered DAGs

2 participants