How to fix Error 221 on Windows 11

by

Troubleshooting Guide: Error 221 – “The File Must Be Checked Out Before Saving Changes”

Why This Error Happens

Error 221 typically occurs when a file is under version control or document management restrictions (common in SharePoint-integrated folders, PDM systems, or Office 365 document libraries synced to Windows 11) and the local session does not hold an active check-out lock. This happens because another user currently has the file checked out, your local sync client lost connection to the server, or file permissions/metadata became corrupted during a previous save or sync interruption. Windows 11’s File Explorer sync engine may also cache outdated lock status, causing it to block save operations even after the lock has been released server-side.

Step-by-Step Resolution Guide

  1. Verify Check-Out Status
    Right-click the file in File Explorer or your document management client and select Properties > Previous Versions (or the equivalent “Check-Out Status” tab if using SharePoint/PDM). Confirm whether the file is locked by another user or session.

  2. Force Check-In from the Server/Admin Panel
    Log into the source system (e.g., SharePoint site, PDM vault, or network share admin console) and locate the file. Use the “Discard Check-Out” or “Override Check-Out” option (requires admin rights) to release the stale lock.

  3. Clear Local Sync Cache
    Close all Office/CAD applications, then navigate to:

   C:\Users\<YourUsername>\AppData\Local\Microsoft\Office\16.0\OfficeFileCache

Delete the cached files related to the document, then restart the OneDrive/SharePoint sync client via Settings > Apps > OneDrive.

  1. Re-map Network Drive or Reconnect Service
    Go to This PC > Map Network Drive, disconnect the existing mapped drive tied to the document library, and reconnect it. This forces Windows 11 to refresh authentication tokens and lock metadata.

  2. Check File Permissions
    Right-click the file > Properties > Security tab. Ensure your user account has Modify and Write permissions. If missing, contact your system administrator to update NTFS or SharePoint group permissions.

Alternative or Verification Steps

  • Verify the Fix: Try saving a small test change to the file. If it saves without the Error 221 prompt, the checkout lock has been successfully cleared.
  • Alternative Solution: If the error persists, save the file locally as a copy (File > Save As), close the original, then manually re-upload/replace it in the document management system to reset its version history.