Forum Discussion

KacperM's avatar
KacperM
Copper Contributor
Jun 04, 2026

OneDrive for macOS documentation issue. DefaultFolder plist example is missing array wrapper

Hi everyone,

The Microsoft Learn documentation for configuring the OneDrive sync app on macOS currently contains an incorrect plist example for the DefaultFolderLocation setting.

 

Documentation page:

https://learn.microsoft.com/en-us/sharepoint/deploy-and-configure-on-macos#defaultfolderlocation

 

In the “DefaultFolderLocation” section, the current plist example shows the DefaultFolder key as a dictionary:

 

<key>DefaultFolder</key>

<dict>

<key>Path</key>

<string>(DefaultFolderPath)</string>

<key>TenantId</key>

<string>(TenantID)</string>

</dict>

 

This format does not work correctly when deployed as a managed preference/configuration profile.

 

The setting starts working when the DefaultFolder dictionary is wrapped in an array, like this:

 

<key>DefaultFolder</key>

<array>

<dict>

<key>Path</key>

<string>(DefaultFolderPath)</string>

<key>TenantId</key>

<string>(TenantID)</string>

</dict>

</array>

 

Please update the Microsoft Learn documentation to include the array wrapper in the DefaultFolder plist example.

The current Microsoft Learn example is confusing because administrators may deploy the documented plist exactly as shown, but the setting does not appear to work correctly until the array wrapper is added.

2 Replies

  • Hi, thanks for documenting this so clearly. The working and failing plist examples, plus the affected OneDrive and macOS versions, make this very actionable. I would use the feedback or Edit option on that Microsoft Learn page to open a documentation issue and include the MDM platform used for testing. If possible, attach a sanitized configuration profile and the relevant OneDrive log entry showing that the dictionary-only form is ignored. That gives the documentation team enough evidence to confirm whether the array is required for multiple tenant/path mappings and update the example without ambiguity.

    • KacperM's avatar
      KacperM
      Copper Contributor

      Hi,

      Before posting on the “Tech Community,” I submitted a report twice through Microsoft Learn, specifically using the “Was this page helpful?” feature in the article but unfortunately, I didn't receive a response, which is why I posted on the “Tech Community.”

      I’m not sure how else I can better convey this to you or how to describe it any better, because I’ve actually already explained everything :)