This is an automated email from the ASF dual-hosted git repository.
jscheffl pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/main by this push:
new 49e6d986b04 Docs: clarify source_dag_run availability in asset event
templates (#60638)
49e6d986b04 is described below
commit 49e6d986b04685d5c58dce437471782f39e50ea3
Author: Rachana Dutta <[email protected]>
AuthorDate: Sat Jan 31 15:08:28 2026 +0530
Docs: clarify source_dag_run availability in asset event templates (#60638)
* Docs: clarify source_dag_run availability in asset event templates
* Update airflow-core/docs/authoring-and-scheduling/asset-scheduling.rst
Co-authored-by: Jens Scheffler <[email protected]>
* Document Jinja limitations for AssetEvent in Airflow 3.1.x
Add note about 'source_dag_run' attribute not being available in Jinja for
Airflow 3.1.x.
---------
Co-authored-by: Rachana Dutta <[email protected]>
Co-authored-by: Jens Scheffler <[email protected]>
---
airflow-core/docs/authoring-and-scheduling/asset-scheduling.rst | 8 ++++++++
1 file changed, 8 insertions(+)
diff --git a/airflow-core/docs/authoring-and-scheduling/asset-scheduling.rst
b/airflow-core/docs/authoring-and-scheduling/asset-scheduling.rst
index 4feaf7e24a9..1bfe98d715e 100644
--- a/airflow-core/docs/authoring-and-scheduling/asset-scheduling.rst
+++ b/airflow-core/docs/authoring-and-scheduling/asset-scheduling.rst
@@ -172,6 +172,14 @@ You can access this information in your tasks using Jinja
templating or directly
Accessing triggering asset events with Jinja
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. note::
+
+ In Airflow 3.1.x, the ``source_dag_run`` attribute of ``AssetEvent`` is not
+ exposed to Jinja templates, and attempting to access it will result in a
+ template rendering error.
+
+.. versionadded:: 3.2.0
+
You can use Jinja templating to pass information from the triggering asset
events to your operators.
**Example: Single Triggering Asset**