Skip to main content
End of Life (EOL) has been announced for Box Sync effective December 2026. For more information visit the official announcement page.
IT Administrators may want to redirect users’ My Documents folders to Box Sync. This type of configuration would allow an organization’s users to use their My Documents folder as they’re accustomed to, while providing added benefits of having those files backed up to the user’s Box account. This is also convenient for certain applications that default to save documents to My Documents.
Disclaimer: Please note that the configurations identified in this document are not officially supported by Box and any configuration changes performed by users or organizations are at your own risk. As these configurations reference changes made to individual machines, Box User Services is not able to provide support and assistance in trouble shooting any issues encountered.
This guide will walk through two ways an administrator can create an end user-initiated utility to assist in this type of folder redirection.

​
Method 1: Utilizing Microsoft APIs

​
Method 2: Utilizing Changes to End Users’ Registries

Note: Both of these options require that an end user has successfully logged in to Box Sync and that a Box Sync folder has been successfully created on their machine. It is not possible to provide redirection of the Box Sync folder before it has been created through a successful authentication.

​
Microsoft APIs

Use of Microsoft APIs allows for a more streamlined solution and does not require end users to restart their machines for the changes to take effect. The information referenced within this section can be written in any language that can access COM APIs (e.g., C, C++, C#, Python, Perl). Refer to the following link for Microsoft’s information on the Windows Shell: https://msdn.microsoft.com/en-us/library/windows/desktop/ff521731(v=vs.85).aspx The following flags are recommended for use:

​
Example Code (written in C)

// Create the KnownFolderManager object IKnownFolderManager *folderManager = 0; CoCreateInstance(CLSID_KnownFolderManager, NULL, CLSCTX_ALL, IID_IKnownFolderManager, (void **)&folderManager); // Perform the redirection LPWSTR error; folderManager->Redirect(FOLDERID_Documents, NULL, KF_REDIRECT_COPY_CONTENTS | KF_REDIRECT_DEL_SOURCE_CONTENTS | KF_REDIRECT_UNPIN | KF_REDIRECT_PIN, boxSyncDocumentsPath, 0, NULL, &error);

​
Registry Changes

Use of registry changes is a secondary approach that can be used by administrators to redirect the user’s Desktop. Documents, Favorites, Pictures, Music, Video, etc. folders to point to folders inside the Box Sync folder. Please note that this option requires a restart to the users’ machines before the change takes effect, and that any movement of files may cause document paths to change. As a result, users may experience unintended impacts (e.g., accessing an old file through “Recent Files” may fail). With this redirection in place, applications will, by default, offer to save files in these folders, and saved documents will automatically be uploaded to Box. Configuration changes should be made by going to the registry at:
  • HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders
The registry can be changed through standard registry APIs. For additional reference material, refer to the following page: https://msdn.microsoft.com/en-us/library/windows/desktop/ms724871(v=vs.85).aspx To migrate all content within a user’s default My Documents folder, the following folders will need to be created within the user’s Box Sync folder:
  • Box Sync\FileSync\Desktop
  • Box Sync\FileSync\Documents
  • Box Sync\FileSync\Favorites
  • Box Sync\FileSync\Pictures
  • Box Sync\FileSync\Music
  • Box Sync\FileSync\Video
Below are the configuration changes that should be made:
Note: On Windows 10, it is a known issue that the ‘Quick Access’ links do not work in this configuration.

​
Example Code

The following is an example of a script that can be used as a starting place for your customized script: https://gist.github.com/anonymous/53b81a190d0e24e93cbb00dd48ab5cc7
Disclaimer The configurations identified in this document are not officially supported by Box and any configuration changes performed by users or organizations are at your own risk. As these configurations reference changes made to individual machines, Box User Services is not able to provide support and assistance in trouble shooting any issues encountered.
Last modified on July 8, 2026