🗓️Airflow Catchup
Also known as Catchup, catchup=True, catchup_by_default
Whether Airflow runs each missed day when a DAG is switched on. Or just the last one.
Think of it like
It is like being away for a week. Do you do all the missed homework, or just today's?
Example
A daily DAG with a start date in January is switched on in March. With catchup on, Airflow makes about 60 runs at once. With it off, it makes one.
Why it matters
It decides whether one click starts one run or hundreds. Hundreds of runs at once can flood a database.
Definition
Example code
python
@dag(schedule="@daily",
start_date=pendulum.datetime(2026, 1, 1, tz="UTC"),
catchup=False)Common mistake
Key takeaways
- 1Missed runs. Dates between start and now.
- 2On or off. All of them, or only the latest.
- 3Per DAG. Each DAG sets its own.