How to Check APFS Snapshots Using Terminal on a Mac

Illustration for How to Check APFS Snapshots Using Terminal on a Mac

Quick Answer

To list APFS snapshots on a Mac, open Terminal and run:

tmutil listlocalsnapshots /

This displays local Time Machine snapshots associated with the Mac’s startup volume. To inspect APFS snapshots more generally, first identify the correct APFS volume, then run:

diskutil apfs listSnapshots /

These commands only display information; they do not delete or modify snapshots. If you want to remove a local Time Machine snapshot, use tmutil deletelocalsnapshots only after confirming its exact date and understanding that deleting it may remove one available recovery point.

What APFS Snapshots Are

An APFS snapshot is a point-in-time view of a volume. Instead of making a complete second copy of every file, APFS records the volume’s state while preserving the data needed to represent that earlier version.

Snapshots can be created by macOS features, including local Time Machine backups, or by other backup and disk-management software. They may help recover an earlier version of files, but they are not a replacement for a separate backup drive. If the Mac’s internal storage fails, snapshots stored on that same storage may also become unavailable.

A snapshot can appear to use little space when first created. As files change or are deleted, the snapshot may retain older blocks, so its storage impact can increase over time. Checking snapshots can therefore help when you are investigating available storage or determining whether an earlier recovery point exists.

Before You Start

Checking snapshots is generally safe, but keep these points in mind:

  • Use a command exactly as shown.
  • Do not add sudo unless a command specifically requires it.
  • Do not delete a snapshot simply because it appears old.
  • Snapshot names and identifiers are case-sensitive.
  • If you are troubleshooting storage, check the correct volume rather than assuming every snapshot belongs to the startup volume.
  • A snapshot is not the same as a complete backup.

Some commands later in this guide can delete snapshots. Those steps are clearly marked. Deletion can remove a recovery point and may be difficult or impossible to undo.

Open Terminal

You can open Terminal from Applications > Utilities > Terminal. You can also press Command-Space, type Terminal, and press Return.

The commands below are read-only unless specifically identified as a deletion command.

List Local Time Machine Snapshots

The simplest check is tmutil listlocalsnapshots. It lists local Time Machine snapshots for the specified volume.

Run this command for the startup volume:

tmutil listlocalsnapshots /

The / at the end means the Mac’s current startup volume. The command does not create, delete, or restore anything.

If local snapshots exist, Terminal may display entries containing dates. If no local snapshots are available, the command may return no snapshot entries. Do not treat an empty result as proof that no APFS snapshots exist anywhere on the Mac; this command is specifically focused on local Time Machine snapshots for the selected volume.

Terminal showing the command tmutil listlocalsnapshots /
Run this command in Terminal for this step.

To check a different mounted volume, replace / with that volume’s mount point. For example, if a volume is mounted at /Volumes/Archive, run:

tmutil listlocalsnapshots /Volumes/Archive

The path must match the volume’s actual mount point. If you are unsure which volumes are present, use diskutil list:

diskutil list

This displays the disks, APFS containers, and volumes detected by macOS. It is a read-only command. For a more detailed explanation of containers and volumes, see how to check APFS containers and volumes in Terminal on a Mac.

List APFS Snapshots with diskutil

diskutil can ask the APFS system for snapshots associated with a volume. Run:

diskutil apfs listSnapshots /

This command examines the APFS volume mounted at /. It does not change the volume or its snapshots.

If you need to inspect another APFS volume, use its device identifier instead. First list available disks and volumes:

diskutil list

Find the identifier for the APFS volume you want to check, such as an identifier in the form diskXsY, then substitute that identifier in the snapshot command:

diskutil apfs listSnapshots diskXsY

Do not copy diskXsY literally unless it is the identifier shown for your volume. The X and Y characters represent values that vary between Macs.

The diskutil apfs listSnapshots command may show snapshot identifiers, names, dates, or other metadata, depending on the volume and the information macOS reports. It is normal for the result to differ between volumes.

Terminal showing the command diskutil apfs listSnapshots /
Run this command in Terminal for this step.

Check Snapshot Details

If a command returns a snapshot identifier, you can use additional APFS commands to inspect information associated with the volume or snapshot. The exact available details depend on the macOS tools and the volume being examined.

Start by checking the APFS structure:

diskutil apfs list

This read-only command displays APFS containers, physical stores, volumes, roles, and related identifiers. It can help you confirm whether you are looking at the intended volume before using any command that changes state.

For a snapshot-specific query, use the snapshot command supported by your Mac’s diskutil version. Display the built-in help text with:

diskutil apfs

This prints the APFS subcommands available on that Mac. Help output is not a snapshot operation and does not modify disks.

Avoid assuming that a snapshot’s displayed size equals the amount of space it currently consumes. Snapshot storage depends on blocks retained because of changes to the live volume. The listing is useful for identifying snapshots, but it may not provide a simple “size used” figure that can be compared directly with free space.

Understand the Results

When reviewing Terminal output, pay attention to these details:

Snapshot date

A date in a snapshot name usually identifies when the snapshot was created. Confirm the date before using it for recovery or deletion.

Volume association

A snapshot belongs to a particular APFS volume. A Mac can contain multiple volumes, so a snapshot listed for the startup volume is not necessarily associated with an external APFS drive.

Local versus external backups

tmutil listlocalsnapshots / is intended for local Time Machine snapshots on the selected volume. It does not list every backup stored on every external drive.

To inspect an external APFS disk, connect it, then identify its volume with:

diskutil list

Use the correct mounted volume or identifier with diskutil apfs listSnapshots. Do not disconnect the drive while Terminal or another application is actively using it.

Snapshots versus backups

A snapshot is stored with the APFS volume. A backup stored on another disk provides protection if the original disk fails. Keep that distinction in mind when deciding whether a snapshot is safe to remove.

Remove a Local Time Machine Snapshot

Only remove a snapshot if you have confirmed that it is no longer needed. Deleting a snapshot can remove a recovery point and may affect your ability to restore files from that point.

First list local snapshots again:

tmutil listlocalsnapshots /

Identify the exact snapshot date shown by Terminal. Then use the date portion required by tmutil deletelocalsnapshots:

tmutil deletelocalsnapshots YYYY-MM-DD-HHMMSS

Replace YYYY-MM-DD-HHMMSS with the exact date and time from the snapshot listing. Do not enter a made-up date or remove a snapshot based only on its age.

This command changes state by deleting the specified local snapshot. It does not delete the live files currently on the volume, but it can remove the older recovery point represented by that snapshot. There is no general undo command for a deleted local snapshot. The safe recovery path is to restore from another available snapshot or backup. If you need files from an existing snapshot, learn how to restore files from an APFS snapshot on a Mac before deleting it.

Terminal showing the command tmutil listlocalsnapshots /
Run this command in Terminal for this step.

Troubleshooting

Terminal says the command is not found

Confirm that you entered the command correctly:

which tmutil
which diskutil

Both tools are normally provided by macOS. If a command is unavailable, do not download a replacement utility from an untrusted source. Check the spelling, reopen Terminal, and make sure you are using the standard macOS Terminal environment.

tmutil listlocalsnapshots / shows nothing

An empty result can mean that no local Time Machine snapshots are available for the startup volume. It can also mean that the snapshots belong to a different volume or that the relevant backup system is not using local snapshots.

Use the following commands to examine the disk layout and APFS snapshots:

diskutil list
diskutil apfs listSnapshots /

If the snapshot is associated with an external drive, connect that drive and run the command against its actual volume.

diskutil apfs listSnapshots / returns an error

The path may not identify an APFS volume, the volume may not be mounted, or the selected identifier may be incorrect. Start with:

diskutil list

Then use the identifier or mount point shown for the intended APFS volume. Be careful when working with external disks that contain multiple volumes.

The Mac reports low storage even though snapshots are present

Snapshots can retain older data blocks, but macOS may manage local Time Machine snapshots automatically when space is needed. Do not delete snapshots blindly as a first response. First identify large files, confirm that important files are backed up, and determine whether the storage issue is actually related to snapshots.

You can inspect APFS information with:

diskutil apfs list

If you decide to remove a local snapshot, verify its exact identifier or date and use the deletion procedure above.

You cannot access files from a snapshot

Listing a snapshot does not automatically mount it in Finder. Snapshot recovery may require a compatible recovery method, backup application, or macOS recovery workflow. Do not modify the snapshot while attempting recovery. If the volume is encrypted, you may need to unlock it before its contents can be accessed. See how to unlock an encrypted APFS volume on a Mac if that applies.

Frequently Asked Questions

Does checking APFS snapshots delete anything?

No. tmutil listlocalsnapshots, diskutil list, diskutil apfs list, and diskutil apfs listSnapshots are inspection commands. They display information without deleting snapshots or changing volume contents.

Can I check snapshots on an external APFS drive?

Yes. Connect and unlock the drive, identify its volume with diskutil list, and then run diskutil apfs listSnapshots using the correct mount point or disk identifier.

Are APFS snapshots full backups?

No. A snapshot is a point-in-time view stored with the APFS volume. It should not be your only copy of important files. Maintain a separate backup on another storage device or backup destination.

Is it safe to delete every old snapshot?

No. An old snapshot may still be useful for recovering an earlier version of a file. Confirm that you have another backup and no longer need the snapshot before deleting it.

Do I need administrator access to list snapshots?

Many listing commands can run without administrator authentication. macOS may request authorization for some operations, especially commands that modify disks or snapshots. Never approve a destructive command unless you understand exactly what it will change.

Final Thoughts

Use tmutil listlocalsnapshots / to check local Time Machine snapshots on the startup volume and diskutil apfs listSnapshots to inspect APFS snapshots more generally. Confirm the volume before interpreting the results, and treat deletion as a destructive action. Snapshots can assist with recovery, but a separate backup remains essential for protecting files and external-drive data.