diff --git a/airflow-core/docs/core-concepts/dags.rst b/airflow-core/docs/core-concepts/dags.rst index b1bb0c8bec294..9bb91ca160416 100644 --- a/airflow-core/docs/core-concepts/dags.rst +++ b/airflow-core/docs/core-concepts/dags.rst @@ -249,6 +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 +~~~~~~~~~~~~~~ + +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 --------------