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:

 

Box Sync 4.0 Initial Troubleshooting-1.png

 

  1. 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.
  2. 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, the sync is in progress.
    • If there are gray icons, there was an error syncing that item.
  3. 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:
problem file notification - windows.png

 

OS X: 

problem file notification.png

 

Check the list below 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 User Services team who will help you troubleshoot the problem further.