Box Sync Troubleshooting Basics

This guide contains common Box Sync issues and what to do if files are not syncing.

To help in troubleshooting, here's a quick example of a healthy Box Sync folder for reference:

• The Box Sync folder appears in the favorites section.
  • If the Box Sync folder is not here, make sure you have Box Sync installed and that is it installed on a local native drive (not a network or external drive). It will be on a local native drive by default.
• Files and folders with blue check mark icons indicate successful syncing.
  • On Windows, if there are no icons, you may be logged out of Box Sync.
  • If there are yellow icons, Box Sync is scanning your folder tree and/or syncing your content.

Mac - Yellow icon

Windows - Yellow icon

• If there are red icons, there was an error syncing that item.

• The Box icon appears in the system tray/menu bar to indicate that Box Sync is running and you are logged in.
  • On Windows this is a blue Box, on Macs it is a black "b".
  • If the Box icon is gray (gray "b" on mac), make sure you are logged in to Box Sync.
  • If the icon is not there, try restarting Box Sync from the Start Menu or Spotlight Search.

Box Sync provides detailed user notifications if a file cannot be synced. To see the list of current problem files, go to the Box Sync icon in your system tray or menu bar and select the "Error Syncing File" option:

Windows:

OS X:

Check Miscellaneous Box Sync Error Notifications for the error notification you've received.

If you are unable to resolve your Sync issue using the resources above, please submit your Sync logs and open a case with our Product Support team who will help you troubleshoot the problem further.