🦊 MigrationFox Docs

Auto-skipped files: what MigrationFox filters out

Every migration drops a handful of OS and application artifact files that have no meaning at the destination — macOS sidecar files, Windows thumbnail caches, Office lock files, trash folders. This page lists exactly what is filtered, why, and roughly how much your source shrinks after.

Real numbers from a 90K-file legal/HR shared drive. Savings skew toward file count, not bytes — junk files are small but numerous.

WHY IT MATTERS

SharePoint charges no tenant quota for junk, but every file is one API call on the upload side and one index entry at the destination. Filtering 44K files off a 90K source roughly halves the run time and cuts the destination index footprint by the same amount.

Why some files are skipped automatically

These patterns represent files the operating system or an application created for its own use — not content a user ever opened, shared, or cared about. Migrating them means:

The filter is on by default and covers the patterns below. There is no list of tenants where we have turned it off.

Full list of patterns

PatternOriginWhat it is
.DS_StoremacOS FinderPer-folder view state (icon positions, window size). Regenerated on browse.
._*macOS AppleDoubleResource-fork sidecar when copying to non-HFS volumes. One per real file.
.Spotlight-V100/macOS SpotlightPer-volume search index. Only meaningful to the Mac that wrote it.
.fseventsd/macOS FSEventsFilesystem-change event log. Meaningless off-device.
.TemporaryItems/macOSIn-flight file copy buffers. Usually empty, occasionally partial.
.Trashes, .Trash-*macOS / LinuxPer-volume or per-user deleted items. Intentionally discarded content.
Thumbs.dbWindows ExplorerFolder thumbnail cache. Regenerated on browse.
ehthumbs.dbWindows MediaMedia thumbnail cache. Same category as Thumbs.db.
desktop.iniWindows ExplorerFolder icon and localization metadata. Does not transfer meaning to SharePoint.
$RECYCLE.BIN/WindowsPer-volume recycle bin. Intentionally discarded content.
~$*Microsoft OfficeLock file while a doc is open. Present = someone had the file open when the source was scanned; the real file is migrated normally.
.~lock.*LibreOffice / OpenOfficeSame concept as Office ~$ files.
thumbdata3-*Android GalleryGallery thumbnail cache. Huge (often 100 MB+), worthless off-device.
.nomediaAndroidMarker telling Gallery to skip indexing the folder. Irrelevant in SharePoint.
*.tmp, *.tempVariousTemp files from partial saves. Often a stale shadow of a file that was later saved properly.
*.swp, *.swovimEditor crash-recovery scratch files.
lost+found/Linux ext*Filesystem-check orphan bin. Recovered fragments — rarely useful.

How much typical sites shrink after filtering

Real examples from production runs:

Count reduction generally sits at 15–50% depending on OS mix. Byte reduction is usually much smaller (1–5% of source size) — junk files are small, but an abundance of them dominates file-count-sensitive timings like scan duration and destination indexing.

TIP

If your scan reports "no junk files found" on a source that has macOS or Windows users, something is wrong — almost always the source credential is missing read on dot-prefixed files. Re-run the scan from an account with full read access. A truly clean source is rare.

How to re-include if needed

The filter is currently global and on by default — there is no opt-out. In practice this has never been requested for junk files, since migrating a Thumbs.db into SharePoint has no legitimate use case. If you have one, tell us.

A per-project override for the junk-file list is on the roadmap. The target shape:

No ETA yet. Vote for it by emailing support@migrationfox.com with your use case — the roadmap is demand-driven.

DON'T

Don't script a workaround by renaming junk files before the scan (e.g., .DS_Storeds_store.bak). You'll pay the full upload cost, clutter SharePoint, and the renamed files still regenerate on macOS browse. If you genuinely need these files, the roadmap override is the right path.

What's next