SharePoint Document Issues

How to Fix SharePoint Cannot Replace an Existing File Error

Jason Miller Oct 19, 2026 869 views

Question details

Users are unable to replace an existing file in SharePoint and receive an upload error, even with owner permissions.

How to Fix SharePoint Cannot Replace an Existing File Error

Product: Microsoft SharePoint
Device & OS: not provided
Scenario: Attempting to drag and drop or upload a file with the same name to replace an existing file and preserve its version history.
Observed behavior: SharePoint blocks the upload and displays the error message 'Something went wrong, so we couldn't upload'.

Before you start

Verify that you have 'Edit' or 'Owner' permissions for the SharePoint document library and ensure that the file is not currently locked or checked out by another team member.

Solution 1Recommended

Disable the Check-Out Requirement in Library Settings

Turning off the mandatory check-out setting often resolves versioning conflicts when replacing files.

SharePoint libraries are sometimes configured to require users to check out documents before editing. This strict versioning control can block direct uploads of files with the same name.

Access Library Settings

Navigate to your SharePoint document library, click on the Settings gear icon in the top right corner, and select 'Library Settings'.

Open Versioning Settings

In the Library Settings menu, click on 'Versioning Settings'.

Disable Check-Out

Scroll down to the 'Require Check Out' section. Under 'Require documents to be checked out before they can be edited', select 'No'.

Save and Retry

Click 'OK' to save your changes. Drag and drop your file back into the library to replace the existing version successfully.

Disable the Check-Out Requirement in Library Settings

Version History Preserved: Uploading the file with the same name after disabling this requirement will seamlessly add the new document as the latest version without losing past history.

Solution 2

Use the Subfolder Upload and Move Workaround

Uploading the file to a different directory first and then moving it can bypass immediate folder restrictions.

Solution 3

Rename the File to Avoid Restricted Terms

Removing certain reserved terms like 'template' from your file name can clear up hidden upload blocks.

Free Microsoft Office alternative

Edit and Manage Documents Seamlessly with WPS Office

If complex SharePoint library settings and Microsoft Office sync errors are slowing down your workflow, consider using WPS Office. It provides a lightweight, robust, and highly compatible alternative for everyday document editing and collaboration without the steep learning curve.

1. Download and Install: Visit the official WPS Office website and download the free version for your operating system.
2. Open Office Files Directly: Use WPS Office to open your existing .docx, .xlsx, or .pptx files seamlessly without format conversion.
3. Save to WPS Cloud: Enable WPS Cloud to automatically sync your documents and manage versions without dealing with complex check-in/check-out rules.

Fully compatible with Microsoft Word, Excel, and PowerPoint formatsLightweight application that uses fewer system resourcesFamiliar tabbed interface for effortless multitaskingBuilt-in cloud solutions for easy file sharing and version management

microsoft office alternative - wps office

Frequently Asked Questions

Why does SharePoint say 'Something went wrong' when replacing a file?

This error typically occurs due to strict document library configurations (like requiring check-outs before editing), permission conflicts, or because the file name contains restricted system words like 'template'.

How do I check out a file in SharePoint?

Select the file in your document library, click the three horizontal dots (Show actions) next to the file name, hover over 'More', and select 'Check out'. This temporarily locks the file so you can safely edit and replace it.

Can I recover version history if I delete the old file and re-upload?

No, deleting a file completely removes its associated version history. To preserve previous versions, you must upload the file using the exact same name to overwrite it, or utilize the check-out/check-in feature.

Are there restricted characters or words in SharePoint file names?

Yes. SharePoint restricts characters such as *, :, <, >, ?, /, \, and |. Additionally, depending on custom site setups, generic terms like 'template' might be flagged by the system, causing upload errors.

Document & File Issues