Skip to main content

Troubleshooting OneDrive Sharing & Syncing Issues

  • Updated

This document was created to support all users — excluding those affiliated with Discovery Education — by providing a clear explanation of why OneDrive may experience failures during large-scale file sharing, syncing, or data migration sessions. It outlines common causes, limitations, and best practices to help users avoid disruptions and ensure smoother collaboration and data management.

There are 3 main things that may prevent a file or sync to not work correctly or as intended. 

1. OneDrive for Mac Naming Restrictions.
:x: Disallowed Characters:

  • ", *, :, <, >, ?, /, \\, |.
  • Leading/trailing spaces.
  • # and % may be blocked by some organizations.

To prevent issues such as this try to avoid using special characters above at together when naming files.  

2. :no_entry_sign: Invalid Names:

  • Reserved names like CON, PRN, AUX, NUL, COM0–COM9, LPT0–LPT9
  • Files starting with ~$.
  • Special folders like forms at root level. (Root level: This means the folder is located at the topmost directory of the site or library — not nested inside another folder.
  • Certain Unicode characters as first character. Example down below....
    • Standard letters and numbers (A-Z, 0-9)
    • Symbols (e.g., ©, ™, €, ✓)
    • Emojis (😊, 🚀)
    • Non-English characters (e.g., ñ, ü, 中)

3. Length Limits:

  • File path: < 400 characters.

    • 📁 What Is a File Path?

    • A file path is the full address of a file on your system. For example:
    • C:\Users\Cam\Documents\Projects\OneDrive\Shared\Team\Reports\2025\August\Final\Summary.docx
  • Individual names: < 255 characters
    • Each file or folder name must be less than 255 characters.
    • This includes letters, numbers, spaces, and symbols in the name.
    • Example:
      • ✅ Project_Report_2025.docx (OK).
      • ❌ This_is_a_very_long_file_name_that_exceeds_the_maximum_allowed_length_and_may_cause_sync_or_access_issues_in_OneDrive_or_SharePoint.docx (Too long) (Spaces count as two "spaces") .
  • Full OneDrive path: < 520 characters.
    • It includes:
      • The OneDrive root directory.
      • All nested folders.
      • The file name and extension.

Example : C:\Users\Cam\OneDrive - DiscoveryEducation\Shared\Projects\2025\August\Reports\Final\Summary.docx

If this entire string exceeds 520 characters, OneDrive may:

  • Show errors or warnings.
  • Prevent sharing or access.
  • Fail to sync file.

 

 

 

Related articles