# Orphan files

Glossary, read 10 Nov 2026

**The short answer.** Orphan files are files under a table's location that no table metadata references, usually left behind by failed tasks or jobs. Normal snapshot expiration may not be able to tell they are unneeded. Iceberg provides a delete orphan files action to find and remove them, and it is meant to be run periodically.

Removing them wrongly is risky. A file that an in-progress write has created but not yet committed looks orphaned, so a short retention interval can corrupt the table.

On the open stack on EMR or EKS it is another job to schedule.

## A sourced example

The Iceberg maintenance page warns that removing orphan files with a retention interval shorter than the time any write needs to complete is dangerous, and gives a default interval of 3 days.

## Sources

- Iceberg documentation: maintenance: https://iceberg.apache.org/docs/latest/maintenance/ (read 10 Nov 2026)

Last reviewed 10 Nov 2026. Canonical: https://datalakehousecompare.com/glossary/orphan-files/
