Australian cloud for business software — built and run in Sydney since 2002

NetLeverage
NetLeverage

OneDrive sync error "Sorry, OneDrive can't add your folder right now": library settings that block syncing

Technical article
Troubleshooting

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.

  1. 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.
  2. 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.
  3. 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.
  4. In the Columns section, note which columns have a check mark under Required.
  5. 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.

  1. Open Library settings, then under General Settings select Versioning settings.
  2. Under Require Check Out, select No (Microsoft's support page shows this as the default).
  3. 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.

  1. Go to Library settings and look at each column in the Columns section.
  2. For each column with a check mark under Required, open it and change "Require this column to contain information" to No.
  3. 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.

  1. Open Library settings, then under General Settings select Versioning settings.
  2. Under Draft Item Security, select Any user who can read items (the default, per Microsoft's support page).
  3. 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.

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