About this article: This article is reviewed against the cited sources. This is source research, not lab validation. Check the stated versions and your own requirements before making changes.
Microsoft's page lists four possible causes for this error when you try to sync a OneDrive or SharePoint team site: the Require Check Out option is on for the library, the library has required columns, Draft Item Security is set to Only users who can edit items, or the person is syncing with an external or guest account. Three of the four are library settings that someone with permission to manage the library can change. The fourth, a guest or external account, is a case on which Microsoft's two pages differ: the error page says syncing with such an account is not supported, and the Restrictions page says "OneDrive supports syncing content as an external or guest user. For requirements, see B2B sync."
Because the settings affect everyone who uses the library, confirm with the library owner before you change one, and write down the current value first.
What the error means
Microsoft's Learn page, "OneDrive sync error Sorry, OneDrive can't add your folder right now", applies to OneDrive for Business. The symptom is a sync of a OneDrive or SharePoint team site that fails with the error "Sorry, OneDrive can't add your folder right now."
The support page "Restrictions and limitations in OneDrive and SharePoint" explains the same area under "Libraries with specific columns or metadata". For libraries with Checkout or Validation columns, or when Draft Item Security is set to either Only users who can edit or Only users who can approve items in Version Settings, two things can happen. For SharePoint document libraries, you synchronise the items as read-only. For OneDrive libraries, OneDrive shows a lock icon next to the sync status and you cannot synchronise the library until you remove the settings.
That page also tells you who may act: "These procedures are for people who have permission to manage the affected library or site. If you can't access the settings, contact the library owner or your SharePoint admin." It adds a warning: "Changes to checkout, draft visibility, content approval, required columns, validation, or permissions affect everyone who uses the library or site. Confirm the changes with the owner before proceeding. Don't remove controls that your organization requires just to enable syncing."
Likely causes
| Cause | What you see | How to confirm |
|---|---|---|
| Require Check Out is on | The error when you select Sync on the library | Library settings, Versioning settings: Require Check Out is Yes |
| The library has required columns | The error; the page lists required columns as a cause | Library settings, Columns: a check mark under Required for one or more columns |
| Draft Item Security is restricted | The error; a lock icon for OneDrive libraries | Library settings, Versioning settings: Draft Item Security is Only users who can edit items (or Only users who can approve items, per the support page) |
| Syncing with a guest or external account | The error for a user who is not internal to your organisation | Check which account the user signed in to OneDrive with |
| Permissions below Contribute | Items sync read-only | Microsoft's page: to sync a file in more than read-only mode, the user must have Contribute permissions or higher |
Microsoft's support page also lists Content Approval, Validation, Offline Client Availability (at library and site level) and Limited-access user permission lockdown mode as settings to check, with the library owner's approval. The Learn page for this error names only the four causes in the table's first four rows.
Prove the cause before changing anything
All of these only read.
- Find out which account the user syncs with. If it is an external or guest account, Microsoft's error page says "Syncing content by using a guest or external account is not supported. Instead, use an account that's internal to your organization." Its Restrictions page says OneDrive supports syncing as an external or guest user and points to the B2B sync requirements. The two statements differ, so a library setting may not be the cause for that user. Neither page lists the B2B requirements.
- Open the library that fails to sync and select Settings, then Library settings. In the classic experience, select the Library tab, then Library Settings. If a settings panel opens, select More library settings.
- Under General Settings, select Versioning settings and read three values: Require Check Out, Draft Item Security and Content Approval. Do not change anything. Write them down.
- In the Columns section, note which columns have a check mark under Required.
- To check the user's permissions, select Permissions for this document library, then Check Permissions for the user.
Example (illustrative): at contoso.com.au, a staff member selects Sync on the Contracts library of the Finance team site and gets "Sorry, OneDrive can't add your folder right now." The library owner reads Library settings and finds Require Check Out set to Yes, Draft Item Security set to Any user who can read items, and one required column, "Client code". Two of Microsoft's causes apply. The account is an internal one, so the guest cause does not.
Fix
Take the fixes one at a time and test syncing after each. Confirm each with the library owner first, as Microsoft's page says; some organisations need these controls for other reasons, and Microsoft says not to remove controls your organisation requires just to enable syncing.
Require Check Out
Before you change it, write down the current value of Require Check Out on the Versioning settings page (for the example it is Yes).
Risk: the next steps turn Require Check Out off for the whole library. Everyone who uses the library stops having to check documents out before editing, which can change how a team avoids edit clashes.
- Open Library settings, then under General Settings select Versioning settings.
- Under Require Check Out, select No (Microsoft's support page shows this as the default).
- Select OK.
To undo it: return to the same page, set Require Check Out back to the value you wrote down, and select OK.
Required columns
Before you change them, write down the name of each column that has a check mark under Required.
Risk: the next steps stop one or more columns being required for everyone who adds documents to the library. Documents can then be saved without that information, and any process that relies on the column being filled in may get blanks.
- Go to Library settings and look at each column in the Columns section.
- For each column with a check mark under Required, open it and change "Require this column to contain information" to No.
- Save each column.
To undo it: open each column you noted and set "Require this column to contain information" back to Yes. Documents saved while the requirement was off keep their blank values.
Microsoft's support page adds that when Management of content types is enabled, required-column information might not be available. Microsoft says to get the library owner's approval before switching content type management off temporarily to reach those settings, and to re-enable it when you are done.
Draft Item Security
Before you change it, write down the current value of Draft Item Security (for the example it is already Any user who can read items, so nothing to change).
Risk: the next steps change who can see draft items in the library. Setting it to Any user who can read items lets everyone who can read the library see draft items.
- Open Library settings, then under General Settings select Versioning settings.
- Under Draft Item Security, select Any user who can read items (the default, per Microsoft's support page).
- Select OK.
To undo it: return to the same page, set Draft Item Security back to the value you wrote down, and select OK.
A guest or external account
Microsoft's error page says to use an account that is internal to your organisation, which means signing the user in to OneDrive with their organisation account. Its Restrictions page says "OneDrive supports syncing content as an external or guest user. For requirements, see B2B sync." Which applies depends on the B2B sync requirements, which neither page sets out. Neither page names a library setting for this cause.
Confirm the fix
- The user selects Sync on the library again and the folder is added to their File Explorer without the error.
- For a OneDrive library that showed a lock icon, the lock icon is gone from the sync status.
- Try opening and editing a file. Microsoft's page says a user needs Contribute permissions or higher to sync in more than read-only mode.
What to watch afterwards
- Users on teams that rely on check-out. Turning it off removes a safeguard, so ask the library owner whether another control is needed.
- New required columns added to the library later. Microsoft's page lists them as a cause, so the error can return.
- Guest and external users. Microsoft's error page says syncing with them is not supported, and its Restrictions page says it is supported under the B2B sync requirements, so check those requirements before you promise a guest that sync will work.
Read next
Related articles you may want next.
- TroubleshootingOneDrive for Business can't sync after a tenant migration, UPN change or password updateOneDrive for Business stuck after a tenant migration, UPN change or password update? Sign out, clear OneAuth and IdentityCache, sign in. Safe steps.Read article
- TroubleshootingOneDrive and SharePoint "path is too long": file name and path limits, invalid characters and blocked namesOneDrive says a path is too long or a name is invalid? Microsoft's limits (260, 400, 520), blocked characters and names, and how to shorten safely.Read article
- HostingHosted file storage: a file server VM, SharePoint/OneDrive or the office NASHow a business decides where shared files live after moving its applications to a hosting provider: a file server alongside the hosted servers, SharePoint and OneDrive, or the existing office NAS, using Microsoft's documented sync limits and an inventory of how files are used.Read article
Risks and limits
These steps have not been run or lab-tested.
Microsoft's Learn page names four possible causes and gives no version range beyond "OneDrive for Business"; check the current page before you rely on the menu names, since SharePoint's settings pages differ between the classic and modern views and Microsoft's support page describes both. It does not say what to do when none of the four applies. The steps change a library that other people use, so never run them on a library you do not own without the owner's approval.
Sources
- OneDrive sync error “Sorry, OneDrive can’t add your folder right now” — Microsoft Learn, page dated 2025-07-14, accessed 22 November 2026
- Restrictions and limitations in OneDrive and SharePoint — Microsoft Support, date not shown, accessed 22 November 2026
This article was originally published on .