# Airflow Catchup

> Whether Airflow runs each missed day when a DAG is switched on. Or just the last one.

**Field:** Data Engineering  
**Category:** Orchestration  
**Also known as:** Catchup, catchup=True, catchup_by_default

## Think of it like

It is like being away for a week. Do you do all the missed homework, or just today's?

## Definition

Catchup decides what Airflow does with runs it missed. A DAG may be switched on days after its start date. With catchup on, the scheduler makes one run for each missed time, oldest first. With catchup off, it makes only the latest run and skips the rest. In current Airflow, catchup is off unless you turn it on. You set it on each DAG.

## 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.

## Example code

```python
@dag(schedule="@daily",
     start_date=pendulum.datetime(2026, 1, 1, tz="UTC"),
     catchup=False)
```

Catchup is off, so Airflow runs only the latest day. It skips the days since January.

## Why it matters

It decides whether one click starts one run or hundreds. Hundreds of runs at once can flood a database.

## Common mistake

Turning catchup on to fill old dates by accident. Use a planned backfill instead, so you choose the dates.

## Three principles

- **Missed runs.** Dates between start and now.
- **On or off.** All of them, or only the latest.
- **Per DAG.** Each DAG sets its own.

## Related terms

- [Airflow DAG Run](https://learn.benibix.com/term/data/airflow-dag-run)
- [Airflow Scheduler](https://learn.benibix.com/term/data/airflow-scheduler)
- [Data Backfill](https://learn.benibix.com/term/data/data-backfill)
- [Workflow Scheduler](https://learn.benibix.com/term/data/workflow-scheduler)
- [Idempotent Pipeline](https://learn.benibix.com/term/data/idempotent-pipeline)

## Told apart from

- [Airflow Catchup vs Backfill](https://learn.benibix.com/compare/airflow-catchup-vs-data-backfill): People think catchup and a backfill are the same thing. Catchup is a switch on a DAG. When the DAG is turned on late, Airflow runs every missed date by itself, all at once. A backfill is a run you ask for, over dates you choose, when you are ready. Catchup happens to you. A backfill is something you plan.

![Five days in a row, from the start date on day 1 to day 5, when the DAG is switched on. With catchup on, all five days get a highlighted run. With catchup off, days 1 to 4 are greyed out as skipped and only day 5 runs.](https://learn.benibix.com/diagrams/dat2-catchup.svg)

---

Source: https://learn.benibix.com/term/data/airflow-catchup
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
