SharePoint
FolderSync can sync with document libraries on SharePoint Online sites (Microsoft 365). Add an account of type SharePoint. This is separate from the OneDrive account type, so existing OneDrive accounts aren't affected.
Experimental
SharePoint support is new and marked as experimental. Please report any issues to us.
Which accounts can I use?
Only Microsoft 365 work or school accounts. Personal Microsoft accounts (outlook.com, hotmail.com) don't have SharePoint and can't log in to this account type. To sync your personal OneDrive, use the OneDrive account type instead.
I get an error saying administrator approval is required, or "No access to SharePoint sites"
To browse SharePoint sites, FolderSync needs the Microsoft Graph permission Sites.Read.All (read the list of sites you have access to). It also asks for Files.ReadWrite.All (read and write files) and User.Read (show your account name).
Many organizations don't let users approve apps themselves. In that case a Microsoft 365 administrator has to approve FolderSync, either through the admin consent prompt shown at login or in the Microsoft Entra admin center under Enterprise applications.
FolderSync only gets access to sites and files that your own user account can already access.
How do I choose where to sync?
When you select a remote folder, FolderSync first shows a list of SharePoint sites. Open a site to see its document libraries (for example "Documents"). You can select a library, or any folder inside it, as the remote folder for a folder pair.
Sites themselves can't be selected. Files are always stored in a document library.
The site I need isn't in the list
FolderSync finds sites three ways: through SharePoint search, through the sites you follow, and by including your organization's root site. A site can be missing from the list if:
- it's hidden from search results, or search hasn't indexed it yet (new sites can take a while)
- you don't follow it
To fix it, enter the site's address in the SharePoint site URLs field on the account screen. You can enter several addresses separated by commas. You can paste any link from inside the site, for example:
https://contoso.sharepoint.com/sites/Photos- the address of a library page, such as
https://contoso.sharepoint.com/sites/Photos/Shared%20Documents/Forms/AllItems.aspx - a "Copy link" sharing link, such as
https://contoso.sharepoint.com/:f:/s/Photos/...
If a site you entered can't be opened, FolderSync shows an error saying whether the site wasn't found or access was denied.
Following a site in SharePoint (the ☆ star on the site's home page) also makes it appear in the list.
Subsites
Subsites (for example /sites/Photos/Archive) are currently not supported.
I get "Access denied to SharePoint site"
Your user account doesn't have access to that site's libraries. Ask the site owner to give you at least edit permission on the site or library.
Uploaded files are not visible to other users
The library probably has Require check-out turned on, or has required metadata columns. Uploaded files then stay checked out to you until they are checked in. Other users can't see them until then.
Turn off Require check-out under Library settings → Versioning settings, or make the metadata columns optional. Otherwise you need to check the files in manually in SharePoint.
Office documents keep showing as changed in two-way sync
SharePoint writes document properties into Office files (.docx, .xlsx, .pptx) after they are uploaded. This changes the file's size and content, so a two-way sync can see the file as modified again. Photos and other non-Office files are not affected.
For Office documents we recommend one-way sync, or excluding them with a filter.
Some files fail to upload with an error
SharePoint doesn't allow certain file and folder names, for example:
- names containing
" * : < > ? / \ | - names starting with
~$or containing_vti_ - names ending with a dot or starting or ending with a space
- reserved names such as
desktop.ini,CON,PRN,AUXandNUL
The full path can also be at most 400 characters. Rename these items or exclude them with a filter.
Does SharePoint keep file versions?
Yes. If versioning is turned on for the library, every time FolderSync replaces a file a new version is created. Older versions count towards your organization's SharePoint storage.
Why is file comparison based on size and date?
SharePoint doesn't provide an MD5 or SHA1 checksum for files. FolderSync therefore compares files by size and modification date. Modification dates set by FolderSync are kept on upload.