SharePoint Co-authoring Problems
Resolution Checklist
- 1 Understand SharePoint Co-authoring Problems
- 2 Disable Library Checkout and Draft Restrictions
- 3 Verify File Formats and Unsupported Features
- 4 Resolve Windows Office Cache and Sync Issues
- 5 Resolve macOS Office Cache and Sync Issues
- 6 Summary Checklist for Co-authoring Problems
SharePoint Co-authoring Problems
Real-time co-authoring allows multiple users to edit documents in Word, Excel, or PowerPoint simultaneously. However, files frequently get locked, showing messages like “File is locked for editing by another user” or “Co-authoring is not available”.
This guide covers the root causes of co-authoring blocks in SharePoint Online and provides step-by-step resolution paths for both Windows and macOS clients.
1. Understand SharePoint Co-authoring Problems
Co-authoring failures are typically caused by library configuration settings, unsupported file features, or local Office cache issues:
- “Require Check Out” is Enabled: If a SharePoint Document Library requires files to be checked out before editing, co-authoring is automatically disabled. Only one person can edit the file at a time.
- Orphaned Local Locks: If a user’s Office client or OneDrive sync engine crashes while editing, SharePoint may maintain a lock on the file for up to 10 minutes (an orphaned session).
- Legacy File Formats: File formats like
.doc,.xls, and.pptdo not support co-authoring. Files must use modern XML formats (.docx,.xlsx,.pptx). - Collaboration Settings Disabled: The OneDrive sync client option “Use Office applications to sync Office files that I open” must be active. If disabled, co-authoring will fail.
- File Encryption or Macros: Password protection, Information Rights Management (IRM) policies, and legacy macros (.xls with VBA) can block multi-user sessions.
2. Disable Library Checkout and Draft Restrictions
To enable co-authoring, SharePoint administrators or site owners must ensure library settings do not enforce checkout rules.
Step 1: Turn off “Require Check Out”
- Navigate to the SharePoint Document Library.
- Click the gear icon (Settings) in the top-right and select Library settings → More library settings.
- Under the General Settings column, click Versioning settings.
- Scroll to the bottom to find Require Check Out.
- Set it to No and click Save.
Step 2: Adjust Draft Item Security
If draft security is too restrictive, users without approval permissions cannot co-author drafts.
- In the same Versioning settings screen, locate Draft Item Security.
- Change the setting to Any user who can read items to allow full co-authoring access to drafts.
- Click Save.
3. Verify File Formats and Unsupported Features
If only specific files fail to co-author, check the files themselves.
Step 1: Convert Legacy Files
- Open the document in your desktop Office application (Word/Excel/PowerPoint).
- If it is in a legacy format (indicated by “Compatibility Mode” in the title bar), go to File → Info.
- Click the Convert button to save the file in the modern XML format (
.docx,.xlsx,.pptx). - Upload the new file to SharePoint and delete the old legacy version.
Step 2: Remove Password Protection
Real-time co-authoring does not support encrypted files.
- Open the file, go to File → Info → Protect Document (or Protect Workbook).
- Select Encrypt with Password.
- Delete the password from the field and click OK. Save the file.
4. Resolve Windows Office Cache and Sync Issues
If co-authoring is blocked due to local cache misalignment on Windows, clear the Office Upload Cache and verify OneDrive sync settings.
Step 1: Terminate Office and OneDrive Processes
Run the following commands in Command Prompt to close all Office apps:
taskkill /f /im winword.exe /im excel.exe /im powerpnt.exe /im OneDrive.exe /im officeclicktorun.exe
Step 2: Purge the Office File Cache
Purge the local cache folder where Office stores temporary sync copies:
rmdir /s /q "%localappdata%\Microsoft\Office\16.0\OfficeFileCache"
Step 3: Enable File Collaboration in OneDrive Settings
- Click the OneDrive icon in your system tray.
- Select Settings (gear icon) → Settings.
- Go to the Sync and backup tab and expand Advanced settings.
- Ensure the File collaboration toggle (“Use Office applications to sync Office files that I open”) is switched ON.
- Restart OneDrive.
5. Resolve macOS Office Cache and Sync Issues
On macOS, corrupted caches in the Microsoft Group Containers can cause persistent file-locking errors.
Step 1: Force Close Office and OneDrive
Open Terminal and terminate all Office programs:
killall "Microsoft Word" "Microsoft Excel" "Microsoft PowerPoint" OneDrive
Step 2: Purge macOS Office Cache Files
Delete the cached directories containing Office metadata and file states:
# Clear MS Office cache folders
rm -rf ~/Library/Containers/com.microsoft.Word/Data/Library/Caches
rm -rf ~/Library/Containers/com.microsoft.Excel/Data/Library/Caches
rm -rf ~/Library/Containers/com.microsoft.Powerpoint/Data/Library/Caches
# Clear global Office Web Cache
rm -rf ~/Library/Containers/com.microsoft.Office365ServiceV2
rm -rf ~/Library/Group\ Containers/UBF8T346G9.Office/msouc.checksum
Step 3: Restart OneDrive Collaboration
Relaunch OneDrive and Office applications. In the OneDrive Mac client, verify under Preferences → Office that “Use Office applications to sync Office files that I open” is checked.
6. Summary Checklist for Co-authoring Problems
| Checked Setting / Area | Action Required | Intended Outcome |
|---|---|---|
| SharePoint Library Settings | Set Require Check Out to No | Allows multiple users to write to the file at once. |
| File Format | Save as .docx, .xlsx, or .pptx | Legacy formats lack the file structure for co-authoring. |
| Active Locks | Wait 10 minutes or force check-in via SharePoint Web | Releases orphaned user locks from crashed applications. |
| OneDrive App (Win/Mac) | Enable File Collaboration / Office Integration | Permits Office and OneDrive to sync edits concurrently. |
| Windows cache | Delete %localappdata%\Microsoft\Office\16.0\OfficeFileCache | Resolves corrupt local file locks and state mismatches. |
| macOS cache | Purge ~/Library/Containers/com.microsoft.* caches | Fixes persistent cached lock errors on Mac. |