Skip to main content

Understanding Free Space on APFS Volumes

What

This article explains why free space on APFS volumes can look different from free space on older file systems such as HFS+.

When/Why

APFS free-space values can move around because macOS accounts for snapshots, clones, sparse files, and shared container space. That matters when you are checking whether a Mac has enough usable storage for updates, deployments, or troubleshooting.

How

  1. Traditional file systems such as HFS+: Free space is usually calculated by subtracting occupied storage blocks from the total volume capacity.

  2. Snapshots: APFS snapshots can hold blocks that look deleted from the live file system. Deleting a snapshot may free space, but the amount depends on what other snapshots still reference.

  3. Clones: APFS cloned files can share storage blocks at first. As the files change, they use additional space. Finder may show the files separately while APFS still accounts for the shared blocks.

  4. Sparse files: Sparse files reserve a logical size that can be much larger than the data they currently store. Copying or saving them without preserving the sparse format can expand them to their full size.

  5. Other volumes: APFS containers share free space across volumes. macOS decides how much space volumes such as Data and VM use inside that shared container.

  6. Free-space estimates: APFS and macOS report changing estimates for available space, including space that can be reclaimed from snapshots or other system-managed storage.

Because APFS can reuse, share, or reclaim blocks, compare the same volume and the same capacity measure before concluding that two tools disagree. Available space can include both currently free blocks and purgeable storage that macOS can reclaim when needed. Do not add the available-space figures for volumes in the same APFS container: they share the same pool, rather than each having that amount of independent free storage.

Compare storage readings on the Mac

  1. Open Disk Utility and choose View > Show All Devices.
  2. Select the volume used by the update or deployment, then choose Info. Note its mount point, capacity, and available space so you are comparing the intended volume.
  3. Check the containing APFS container and its other volumes. If a volume has a quota, that quota limits how much it can allocate even when the container has more space.
  4. Compare readings taken at roughly the same time and check whether each tool reports free, available, or reclaimable space. Recheck the affected installer or deployment after resolving its storage requirement; a larger number in another tool is not proof that the operation completed.

See Apple's Disk Utility information guide for the read-only inspection steps and APFS volume guide for shared space, reserves, and quotas. You do not need to erase a volume or delete snapshots just to compare these readings.

The optional third-party diskspace tool linked below reports several APFS capacity measures, not one definitive free-space value. Its Important capacity is the value its documentation compares with Finder; Opportunistic capacity is for nonessential storage. Apple explains the distinction in Checking Volume Storage Capacity. These values do not establish which measure a particular FileWave inventory field or installer uses.

  1. Free space on an APFS volume is an illusion – The Eclectic Light Company
  2. GitHub - scriptingosx/diskspace: macOS command line tool to return the available disk space on APFS volumes

No comments to display