This is an automated email from the ASF dual-hosted git repository.
vatsrahul1001 pushed a commit to branch v3-4-test
in repository https://gitbox.apache.org/repos/asf/airflow.git
commit 86808ca52c9cc523cc43e3bfb73a7126ffcd9f4f
Author: github-actions[bot]
<41898282+github-actions[bot]@users.noreply.github.com>
AuthorDate: Tue Nov 3 15:22:40 2026 -0500
[v3-4-test] Document the Dag Versions comparison tab in the UI overview
(#76387) (#76390)
The UI gained a Versions tab on the Dag page that compares two stored
versions of a Dag, but the UI overview page did not mention it. Add a
section next to the other Dag tabs describing how to pick versions, what
the change table shows, who can see values, and the Max changes limit,
with dark and light screenshots.
(cherry picked from commit 9612ea5846dc2659e922953e733911752665708f)
Co-authored-by: Jed Cunningham
<[email protected]>
---
.../docs/img/ui-dark/dag_overview_versions.png | Bin 0 -> 115759 bytes
.../docs/img/ui-light/dag_overview_versions.png | Bin 0 -> 112317 bytes
airflow-core/docs/ui.rst | 32 +++++++++++++++++++++
3 files changed, 32 insertions(+)
diff --git a/airflow-core/docs/img/ui-dark/dag_overview_versions.png
b/airflow-core/docs/img/ui-dark/dag_overview_versions.png
new file mode 100644
index 00000000000..38dc886eb67
Binary files /dev/null and
b/airflow-core/docs/img/ui-dark/dag_overview_versions.png differ
diff --git a/airflow-core/docs/img/ui-light/dag_overview_versions.png
b/airflow-core/docs/img/ui-light/dag_overview_versions.png
new file mode 100644
index 00000000000..3f6e53f3780
Binary files /dev/null and
b/airflow-core/docs/img/ui-light/dag_overview_versions.png differ
diff --git a/airflow-core/docs/ui.rst b/airflow-core/docs/ui.rst
index 4c522b96f33..d490d68f28d 100644
--- a/airflow-core/docs/ui.rst
+++ b/airflow-core/docs/ui.rst
@@ -328,6 +328,38 @@ The **Details** tab provides configuration details and
metadata for the Dag, inc
.. image:: img/ui-light/dag_overview_details.png
:alt: Dag Details Tab (Light Mode)
+Versions Tab
+''''''''''''
+
+.. versionadded:: 3.4.0
+
+The **Versions** tab compares two versions of the Dag. Pick a version in
**Compare from** and another in
+**Compare to**, and the tab lists every change between them: the path of what
changed, whether it was added,
+changed or removed, its category (for example task, schedule, param or asset)
and its impact. Changes that
+affect execution, such as a task's operator or retries, are marked separately
from metadata-only changes like
+a description or tag.
+
+The **Before** and **After** columns, and the names in each path, are shown
only to users who can read the
+Dag's code. Other users still see what kind of change was made, with
identifying names in the path masked and
+the values marked as hidden. A large comparison is cut at 500 changes by
+default; set **Max changes** (up to 5000) to see more. The selected versions
are kept in the URL, so a
+comparison can be shared as a link.
+
+.. tab-set::
+ :sync-group: ui-theme
+
+ .. tab-item:: Dark
+ :sync: dark
+
+ .. image:: img/ui-dark/dag_overview_versions.png
+ :alt: Dag Versions Tab (Dark Mode)
+
+ .. tab-item:: Light
+ :sync: light
+
+ .. image:: img/ui-light/dag_overview_versions.png
+ :alt: Dag Versions Tab (Light Mode)
+
.. _ui-dag-runs:
Dag Run View
