This is an early draft of the changes coming in Airflow 3 which can have backwards compatibility impact.
The data below is captured from the "newsfragments" incorporated into the Pull Requests and is intended to give a quick summary overview of the changes.
At this point, the attached GoogleSheets link is the source of truth (for easier and more broad editing) and the table below is a view of that sheet.
AIP/PR (Newsfragment) | Title | DAG changes | Config changes | API changes | CLI changes | Behaviour changes | Plugin changes | Notes | Doc link (if any) |
|---|---|---|---|---|---|---|---|---|---|
| 24842 | Default DAG schedule changed to None | N | N | N | N | Y | N | When a schedule parameter is not passed to the DAG constructor, Airflow now defaults to never automatically schedule the DAG at all. The created DAG can still be manually triggered, either by the user directly, or from another DAG with TriggerDagRunOperator. | |
| 40029 | Deprecated allow_raw_html_descriptions | N | N | N | N | N | Y | Remove deprecated allow_raw_html_descriptions from UI Trigger forms | |
| 40931 | Deprecated store_serialized_dags | N | N | N | N | ? | N | Removed dagbag deprecated store_serialized_dags parameter. Please use read_dags_from_db parameter. | |
| 40936 | on_success_callback no longer called if task skipped | N | N | N | N | Y | N | on_success_callback will no longer execute if a task is skipped. Previously, this callback was triggered even when the task was skipped, which could lead to unintended behavior or inconsistencies in downstream processes. This is a breaking change because workflows that rely on on_success_callback running for skipped tasks will need to be updated. Consider updating your DAGs to handle cases where the callback is not invoked due to task skipping. | |
| 41096 | Deprecated process_poll_interval | N | Y | N | N | N | N | Removed deprecated processor_poll_interval configuration parameter from scheduler section. Please use scheduler_idle_sleep_time configuration parameter. | |
| 41348 | AIP-74 (Rename Dataset to Asset) | ??? | ??? | Y? | ? | N? | N? | Big set of changes to rename Dataset to Asset. Touches many core Airflow packages. Unclear, if backward compatibility shims were added? | |
| 41366 | Deprecated airflow.contrib | N | N | N | N | N | N | airflow.contrib modules have been removed. All modules from airflow.contrib which were deprecated in Airflow 2, have been removed. | |
| 41367 | Deprecated ImportError | Y | N | N | N | N | N | Deprecated ImportError removed from airflow.models The deprecated ImportError class can no longer be imported from airflow.models. It has been moved to airflow.models.errors.ParseImportError. | |
| 41368 | Deprecated core imports | Y | N | N | N | N | N | Support for deprecated core imports removed Support for importing classes etc from the following locations was deprecated at various times during Airflow 2s lifecycle, and has been removed: airflow.executors airflow.hooks airflow.macros airflow.operators airflow.sensors Instead, import from the right provider or more specific module instead. For example, instead of from airflow.sensors import TimeDeltaSensor, use from airflow.sensors.time_delta import TimeDeltaSensor. | |
| 41390 | Deprecated SubDAGs | Y | N | Y | Y | N | N | Subdags have been removed from the following locations: CLI API SubDagOperator This removal marks the end of Subdag support across all interfaces. Users should transition to using TaskGroups as a more efficient and maintainable alternative. Please ensure your DAGs are updated to remove any usage of Subdags to maintain compatibility with future Airflow releases. | |