How to Fix Word Document Preview Problems in SharePoint Online
Question details
Users need to resolve issues where Word document previews in SharePoint Online incorrectly display images or have broken table-of-contents links.
- Product
- SharePoint Online
- Device & OS
- not provided
- Scenario
- Viewing uploaded or recently migrated Word documents using the SharePoint Online preview functionality.
- Observed behavior
- Images fail to render correctly and clickable table-of-contents links become unresponsive within the online document previewer.
Verify that you have sufficient permissions in your SharePoint Online library to create, download, and re-upload documents before proceeding with these tests.
Test File Integrity and Re-upload Migrated Documents
Determine if the preview issue is isolated to migrated files and resolve it by re-uploading them to SharePoint.
Often, document formatting and link behaviors are disrupted during a bulk migration process. Isolating the issue helps determine if it is a general platform bug or specific to the migration batch.
Navigate to your SharePoint library, click 'New', and select 'Word document' to create a blank file directly within the platform.
Modify the permissions of this newly created test document so that it has read-only access, mimicking the state of your affected files.
Open the test document in the SharePoint previewer. If images and links work correctly, the issue is likely isolated to your migrated files.
Select a small number of the problematic migrated files, download them to your local computer, and then upload them back into the SharePoint library to refresh their preview rendering.
Reproduce the Bug and Submit a Support Request
If the preview errors persist on newly created files, document the bug and escalate it to Microsoft 365 support.
View and Edit Word Documents Seamlessly with WPS Office
If SharePoint Online previews are disrupting your workflow with rendering glitches, try WPS Office. It provides a lightweight, highly compatible alternative to Microsoft Word, ensuring your documents, table of contents, and images display perfectly on your desktop without relying on web-based previewers.
- 1. Download WPS Office: Get the free installer from the official WPS website and complete the installation on your device.
- 2. Open your document: Download your problematic file from SharePoint, launch WPS Writer, and open the document locally.
- 3. Navigate without issues: Use the table of contents and view your images with complete accuracy, bypassing the online preview glitches.

Frequently Asked Questions
Why are my Word document images not displaying correctly in the SharePoint preview?
This often happens due to web browser rendering limitations or minor data corruptions introduced during file migration. Downloading the file and re-uploading it to SharePoint frequently resolves these rendering glitches.
How do I fix broken table-of-contents links in SharePoint Online?
If the links break only in the online preview mode, opening the document in a dedicated desktop application will bypass the issue. If the problem happens consistently on new files, it is likely a platform bug that requires an administrator to submit a Microsoft support request.
Does migrating files to SharePoint affect document formatting?
While the core data remains intact, the online previewer can sometimes struggle to correctly cache and render elements like high-resolution images and internal hyperlinks on files freshly migrated from on-premises servers or older systems.




