Fix Broken Image Web Parts After SharePoint Online Migration
Question details
Users need to resolve an issue where image web parts fail to display correctly after migrating sites to SharePoint Online.

- Product
- SharePoint Online
- Device & OS
- not provided
- Scenario
- Migrating existing SharePoint sites to SharePoint Online using tools like ShareGate.
- Observed behavior
- Image web parts that functioned normally before the migration are broken and fail to load images in the new SharePoint Online environment.
Ensure you have site editing privileges and verify that the image files referenced by the web parts were successfully included in the initial migration payload.
Perform Diagnostic Testing for Web Parts
Isolate the root cause by testing the image web part across different pages, sites, and browsers.
Before making structural changes, it is important to determine whether the broken image is caused by a corrupted page layout, a browser cache issue, or a network block.
Click 'Edit' on the affected SharePoint page and insert a completely new image web part to see if a newly added image renders properly.
Create a new page within the same SharePoint site directory and insert an image web part to rule out page-level corruption.
Navigate to a different SharePoint site within your tenant and verify if image web parts work correctly there.
View the affected SharePoint page using an alternative web browser (such as Edge or Chrome) or disconnect from your VPN/current network to rule out caching or firewall blocks.

Review Migration Logs and Escalate
If the issue is strictly isolated to the migrated site and affects all web parts, consult the migration logs and contact Microsoft Support.
Discover a Seamless Document Collaboration Alternative
While troubleshooting complex SharePoint migration issues, you may need a reliable, lightweight alternative for document management and team collaboration. WPS Office provides comprehensive tools for word processing, spreadsheets, and presentations with high compatibility with Microsoft formats, completely free.
- 1. Download WPS Office: Visit the official WPS website to download the free installation package for your operating system.
- 2. Install and Launch: Follow the on-screen prompts to install the lightweight suite and launch the application.
- 3. Manage and Share Documents: Save your files to WPS Cloud and generate secure sharing links to collaborate with your team without complex site setups.

Frequently Asked Questions
Why do images break during a SharePoint migration?
Images can break if the file paths change between environments, permissions are not mapped correctly, or the migration tool fails to transfer the underlying asset files to the destination document library.
Does ShareGate automatically fix broken web part links?
ShareGate attempts to resolve URLs during migration, but custom web parts or complex page structures might require manual link correction or re-adding the web part after migration.
How do I know if the issue is browser-related?
Testing the same SharePoint page in an incognito window or a completely different browser (like Edge, Chrome, or Firefox) will quickly reveal if the broken images are caused by a local browser cache or extension issue.
Who can open a support ticket for SharePoint Online?
Only a Microsoft 365 global administrator or a designated support administrator can open support tickets directly through the Microsoft 365 Admin Center.




