From d82529a9d5a98098a5734a7575fdcc5dc9ebe3f7 Mon Sep 17 00:00:00 2001 From: Shlesha Ghanekar Date: Sat, 7 Feb 2026 21:54:02 +0530 Subject: [PATCH 1/2] Add documentation for DAG versioning behavior Adds documentation explaining DAG versioning behavior in Airflow 3, clarifying how DAG runs are associated with DAG versions when definitions change. Closes #38571 --- airflow-core/docs/core-concepts/dags.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/airflow-core/docs/core-concepts/dags.rst b/airflow-core/docs/core-concepts/dags.rst index b1bb0c8bec294..df2843a8410d9 100644 --- a/airflow-core/docs/core-concepts/dags.rst +++ b/airflow-core/docs/core-concepts/dags.rst @@ -249,6 +249,17 @@ date would then be the logical date + scheduled interval. For more information on ``logical date``, see :ref:`data-interval` and :ref:`faq:what-does-execution-date-mean`. +DAG Versioning +~~~~~~~~~~~~~~ + +In Airflow 3, DAGs are versioned automatically when their definition changes. +A new DAG version is created whenever the DAG structure is modified, for example +when tasks or dependencies are added, removed, or updated. + +Each DAG run is associated with the version of the DAG that existed at the time +the run was scheduled. Changes made to a DAG after a run has been scheduled do +not affect already running or completed DAG runs. + Dag Assignment -------------- From 23231c345f3cc388cb60ca7b9ad5a5da803f100f Mon Sep 17 00:00:00 2001 From: Shahar Epstein <60007259+shahar1@users.noreply.github.com> Date: Sat, 7 Feb 2026 19:04:11 +0200 Subject: [PATCH 2/2] Update airflow-core/docs/core-concepts/dags.rst --- airflow-core/docs/core-concepts/dags.rst | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) diff --git a/airflow-core/docs/core-concepts/dags.rst b/airflow-core/docs/core-concepts/dags.rst index df2843a8410d9..9bb91ca160416 100644 --- a/airflow-core/docs/core-concepts/dags.rst +++ b/airflow-core/docs/core-concepts/dags.rst @@ -249,17 +249,14 @@ date would then be the logical date + scheduled interval. For more information on ``logical date``, see :ref:`data-interval` and :ref:`faq:what-does-execution-date-mean`. -DAG Versioning +Dag Versioning ~~~~~~~~~~~~~~ -In Airflow 3, DAGs are versioned automatically when their definition changes. -A new DAG version is created whenever the DAG structure is modified, for example -when tasks or dependencies are added, removed, or updated. - -Each DAG run is associated with the version of the DAG that existed at the time -the run was scheduled. Changes made to a DAG after a run has been scheduled do -not affect already running or completed DAG runs. +In Airflow 3, Dags are versioned automatically when their definition changes. +A new Dag version is created whenever the DAG structure is modified, for example when tasks or dependencies are added, removed, or updated. +Each Dag run is associated with the version of the Dag that existed at the time +the run was scheduled. Changes made to a Dag after a run has been scheduled do not affect already running or completed DAG runs. Dag Assignment --------------