Using Box Drive Basics

Supported Operating Systems

Two latest version of macOS.

Windows & Windows Server - The two latest major versions (64-bit)

Working in Finder

If you use a Mac, you can access Box Drive by opening Finder. In the sidebar, navigate to Devices > Location > Box.

Open this folder to display all of the contents of your Files page on Box.com. You can navigate through any folder and open every file you see just as if it were a local file.  Box Drive icons tell you at a glance the status of your files and folders. 

For each file in the Box folder, Box Drive displays these standard properties:

• File name
• File size
• File type
• Date created (more information on Box timestamps)
• Date modified (more information on Box timestamps)

Box Drive icons tell you at a glance the status of your files and folders.

For supported document, video, audio and image file types, when you view files in Box Drive, you will see thumbnails of the file content instead of a generic file type icon. To learn which file types are supported, visit Get Thumbnail Representation.

Working in Explorer

If you use Windows, you can access Box Drive by opening Explorer and navigating to the folder named Box. Open this folder to display all of the contents of your Files page on Box.com. You can navigate through any folder and open every file you see just as if it were a local file.

For each file in the Box folder, Box Drive displays these standard properties:

• File name
• File size
• File type
• Date created (more information on Box timestamps)
• Date modified (more information on Box timestamps)

Box Drive icons tell you at a glance the status of your files and folders.

For supported document, video, audio and image file types, when you view files in Box Drive as Extra large icons, Large icons, Medium icons, Tiles, or Content, you will see thumbnails of file content, rather than generic file type icons. The supported file types are listed in this topic of the Box developer documentation.

You can also right-click a file or folder to display additional actions such as:

• Share
• Send to Box Sign
• Refresh file

Logging in to Box Drive

You can use the Box Drive app to access and edit all your Box files from your desktop.

1. Download Box Drive and open it.
2. Click Log In if you already have a Box account,

Your browser opens - you can now login to your account or create one.

If the Device Trust is enabled for your enterprise, you need to have Box Tools installed on your device to login to Box Drive. If Box Tools is already installed, no additional updates are required.

If Box Tools is not installed, you can install its latest version from  Box downloads.

A loading screen with message Launching Box Drive... appears. You will be prompted to open the Box app in the browser. Once you log in, you can start working with your Box files in the Windows Explorer or macOS Finder.

Working with Other Applications

Working with Box files in other applications such as Word or Excel is seamless. Open the file from Box Drive and work with it as you usually would. When you're done, save the file. The file automatically syncs back to Box. You can also use Save As to save the file to a new location, save the file with a new name, or create new folders to store your file. All of those changes save automatically in Box.

You can also use Save As to easily save new local files into Box Drive. To do this, select the Box location and browse to find the folder you want to contain your file. 

Box Drive Icons and File or Folder Status

Box Drive icons tell you at a glance the status of your files and folders.

Icons in Windows

	Item is up-to-date in Box and available online only.
	Item is problematic. For more information on problem items and how to resolve them, see Problem Item Notifications.
	Item is in the process of being saved to Box.
	Item is locked.
	Item is marked for offline access.
	Item is marked available offline and online
	Item is open in an active co-authoring session.

Icons in Mac

No icon	Item is up-to-date in Box.
	Item is not downloaded to the device's hard drive.   You do not need to click this item to open files or folders with Box Drive. You can select files and folders by clicking this item, or open them by double-clicking on this item. When you double-click on the item, Box downloads the item and displays its contents in the default application you've chosen for the file type.
	Item is not saved to Box.
	Item is being downloaded to the device's hard-drive, or is being saved to Box.
	Download is in progress.
	Item is a problem item. For more information on problem items and how to resolve them, see Problem Item Notifications.
	Item is being saved to Box.
	Item is locked.
	Item is marked for offline access.
	Item is open in an active co-authoring session.

Marking Content for Offline Use

You can also mark content in Box Drive to make it available offline. Drive downloads this content to your device's hard drive so you can work when you're not connected to the Internet. When you get back online, Drive automatically uploads the revised content, so you are always working with the most up-to-date versions of your files. More information about making content available offline.

Note

You cannot make G Suite files (Google Docs, Sheets, and Slides) and Box Notes available to work offline. These are all online-only formats.

Searching Box Drive

As with the Web, searching is the fastest way to locate your content.  You can search either through Box Drive entirely, or through a specific Box Drive folder. Searching through a specific folder can be a more efficient way to find the content you're seeking. It also gives you more granular search capabilities. 

Searching on a Mac

To begin searching on a Mac, in your menu bar, click the Box icon to open the Box Drive search interface. 

• • Alternatively, use the keyboard shortcut Ctrl + Option + Cmd + Space.

Now do one of the following:

• To search throughout Box Drive, type in your search term(s). Results display as you type.
  • To display a result, double-click on it.
  • To get more information about a result, right-click on it.
• To search within a specific Box Drive folder: 
  1. At the bottom left, click the Search inside a Folder icon ().  The Browse for Folder window opens.
  2. Click the folder you want.  Then click OK.
  3. Type in your search terms.  Results display as you type.

You can also search through a specific folder via Finder.  To do this, in Finder right-click on the folder you want and then click Search in this Folder.

The Box search interface opens with the folder pre-selected.  At the top of this window, in the Search Box area, type in your search term.

Unhiding content

Search for the content and then right-click the item and click Unhide File or Unhide Folder; item will reappear in Finder. See Hiding files and folders in Box Drive for more information on hiding content in Box Drive

Searching on Windows

To begin searching on Windows, in your menu bar, click the Box icon to open the Box Drive search interface.

• Alternatively, use the keyboard shortcut Ctrl + Shift + Alt + B.

Now do one of the following:

• Search throughout Box Drive. To do this, type in your search term(s). Results display as you type.
  
  • To display a result, double-click on it.
  • To get more information about a result, right-click on it.
• Search within a specific Box Drive folder.  To do this:
  
  1. At the top right, click the Search inside a Folder icon ().  The Browse for Folder window opens.
  2. Click the folder you want.  Then click OK.
  3. Type in your search terms.  Results display as you type.

You can also search through a specific folder via Windows Explorer.  To do this, in File Explorer right-click on the folder you want and then click Search in this Folder.

The Box search interface opens with the folder pre-selected.  At the top of this window, in the Search Box area, type in your search term.

Unhiding content

Search for the content and then right-click the item and click Unhide File or Unhide Folder; item will reappear in File Explorer. See Hiding files and folders in Box Drive for more information on hiding content in Box Drive

Note

For both Windows and Mac machines, if you recently added a new file or folder to Box, it may take a few minutes to see the item in your results after the upload finishes.

Logging Out of Box Drive

Logging out completely removes all traces of your Drive usage from your machine and enables you to log in again as a new user. Also, when you log out, your Box Drive session ends and the login screen displays. In addition, logging out of Box Drive deletes all of the downloaded content you had marked for offline availability. This of course clears up hard disk space on your device. It also returns to an online-only state all of the content you have marked for offline availability. You will have to repeat the process of marking folders for offline availability.

To log out on a Mac:

1. Navigate to the search menu by going to the menu bar and clicking the Box icon.
   •  
     • Alternatively, you can use the keyboard shortcut Ctrl + Option + Cmd + space.
2. Click the gear icon, and from the list that displays click Log Out.  

Box Drive prompts you with an alert about the following types of files:

• Open Files - You can save and close these files to prevent the loss of any work.
• Items Uploading - You can wait for these to upload to Box. Box Drive cancels any uploads that do not complete before you log out.
• Problem Items - These are local files or folders that cannot be synced back to Box. Logging out deletes these items. To view these items, navigate to the Search Menu, click the gear icon, and from the list that displays click Error Updating an Item....

To log out on Windows

1. Navigate to the search menu by going to the system tray and clicking the Box icon.
   •  
     • Alternatively you can use the keyboard shortcut Ctrl + Alt + Shift + B.
2. Click the gear icon, and from the list that displays click Log Out.

Box Drive prompts you with an alert about the following types of files:

• Open Files - You can save and close these files to prevent the loss of any work.
• Items Uploading - You can wait for these to upload to Box. Box Drive cancels any uploads that do not complete before you log out.
• Problem Items - These are local files or folders that cannot be synced back to Box. Logging out deletes these items. To view these items, navigate to the Search Menu, click the gear icon, and from the list that displays click Error Updating an Item....

Manually Resetting Box Drive

In rare instances Box Drive fails to launch. Manually resetting Box Drive can often resolve this.

New Version - To reset Box Drive on Windows 

1. Exit Box Drive (if it is running). If necessary, use Task Manager to end the Box.exe process.
2. Run command

   "C:\Program Files\Box\Box\FS\cf\cfctl.exe" drive reset Box

   on command prompt. Files not uploaded to Box will be saved to the Desktop with a timestamp.
   1. The output should say “Box Drive reset completed successfully” at the end. If this is not so, then it may be that some files were still open and could not be deleted. Once everything is closed, a re-run of step 2 should be successful.
3. From RegEdit, delete the registry entries under HKEY_CURRENT_USER/Software/Box/Box to clear Box preferences.
4. Restart the Box Drive and follow the prompt to log back in.

If you are still having trouble, open a support ticket.

Legacy Version - To reset Box Drive on Windows 

1. Exit Box Drive (if it is running). If necessary, use Task Manager to end the Box.exe process.
2. Ascertain whether any files exist in C:\users\[USERNAME]\AppData\Local\Box\Box\unsyncedFiles. These are files that have not been uploaded to Box. If these files do exist, and if you want to keep them, copy them to any location outside of C:\users\[USERNAME]\AppData\Local\Box\Box\ (such as your desktop). Proceeding with the steps below deletes these files.
   • You may need to show hidden folders to see \AppData.
3. Delete this folder: C:\users\[USERNAME]\AppData\Local\Box\Box.
4. From RegEdit, delete the registry entries under HKEY_CURRENT_USER/Software/Box/Box to clear Box preferences.
5. Restart the Box Drive and follow the prompt to log back in.

If you are still having trouble, open a support ticket.

To manually reset Box Drive on a Mac 

1. Quit Box Drive if it is running.
2. Download and open the Box Reset Tool zip file.
3. Open the Box Reset Tool from the Downloads folder.
4. Click Reset.
   • You should see a prompt stating “Box Drive reset successfully”.
     
5. Open Box from your application folder and log back in. 

Once you restart Box Drive, you can review any archived unsynced files and either upload them manually or delete them to free up hard drive space.

If you are still having trouble, open a support ticket.

Quitting Box Drive

Exiting Box Drive does not remove any locally stored Box Files from your computer and it does not log you out. If when you exit there are changes in the midst of being saved, the next time you open Box Drive it picks up right where it left off and finishes saving these changes.

To Quit Box Drive on a Mac

1. Click the Box icon from the top menu bar.
   • Alternatively, use the keyboard shortcut Ctrl + Option + Cmd + space.
2. Click the gear icon, then select Quit.
3. Follow the prompts to close any open files and quit Box Drive.

To Quit Box Drive on Windows

1. From the task bar, open the system tray in the lower right corner and click the Box icon.
   • Alternatively, you could use the keyboard shortcut Ctrl + Alt + Shift + B.
2. Click the gear icon, and select Exit.
3. Follow the prompts to close any open files and quit Box Drive.