Skip to content

Add documentation for Dag versioning behavior #61605

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

Closed
shleshaG wants to merge 2 commits into from
Closed

Add documentation for Dag versioning behavior #61605

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d82529a
Add documentation for DAG versioning behavior
shleshaG Feb 7, 2026
23231c3
Update airflow-core/docs/core-concepts/dags.rst
shahar1 Feb 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions airflow-core/docs/core-concepts/dags.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
--------------

Expand Down