Skip to content

Skipped items

Sometimes a sync finishes without errors, but some files or folders weren't synced. These items are skipped on purpose, and the Sync log details screen shows how many were skipped and why (see Sync status).

Skipped items are not errors. They are skipped the same way on every sync until the reason goes away.

Skipped items are never deleted

FolderSync never deletes a skipped item on the other side, and never deletes a folder that contains skipped items, even if deletion is enabled for the folderPair.

Excluded by filters

The item doesn't match the filters on the folderPair. Either it matches an exclude filter, or the folderPair has include filters and the item doesn't match any of them. Only the number of excluded items is shown, not each item.

If files you expected are missing, check the folderPair's filters. Remember that sub folders of an included folder aren't synced unless they also match a folder include filter.

Skipped - provider limitation

The service you sync to (or from) can't store or read the item. The sync log shows the exact reason for each item. Some examples:

Message Cause
OneDrive doesn't allow folder/file names that end with "." OneDrive and SharePoint don't allow names ending with a dot, starting with .., or starting or ending with a space
SMB doesn't allow these characters in file/folder names: / ” : < > | * ? SMB shares (Windows, most NAS devices) don't allow these characters
Windows doesn't allow these characters in file/folder names… The target is a Windows computer (FolderSync Desktop), which doesn't allow \ / : * ? " < > \|, names ending with a space or dot, or reserved names like CON and NUL
File/folder names can't be longer than 255 characters The name is too long for the target file system
Box only supports names of 255 characters or less Box name rules
Box limits upload size to … bytes The file is larger than your Box plan allows
HiDrive maximum upload file size is 2 GB The file is too large for HiDrive
Native Google Drive files cannot be synced Google Docs, Sheets, Slides and other Google files aren't real files and can't be downloaded
File type not supported by Immich Immich only accepts photos and videos
Immich albums cannot contain subfolders Immich can only create folders (albums) in the root

To sync these items, rename them so they follow the target's rules, or exclude them with a filter so they no longer show up as skipped. See Provider differences for the rules of each service.

Skipped - online-only files

The file only exists online and has no content that can be downloaded, for example Dropbox Paper documents and other files Dropbox marks as not downloadable. Open these files in the service's own app or website instead.

Skipped - temporary transfer file

Files ending in .tacitpart are temporary files FolderSync creates while uploading or downloading. When the transfer finishes, the file is renamed to its real name. If a sync is interrupted (for example the connection drops or the app is stopped), a .tacitpart file can be left behind.

These files are never synced as real files. FolderSync deletes leftover temporary files the next time it scans the folder, and you can also safely delete them yourself.

Skipped - empty folders

The folderPair has Do not create empty folders enabled (see folderPair settings), and the folder is empty or only contains items that are skipped or don't need syncing. The folder is created as soon as it contains something to sync.