SharePoint Document Issues

Fix Broken Image Web Parts After SharePoint Online Migration

Amos GikundaAmos Gikunda Nov 2, 2026 870 views

Question details

Users need to resolve an issue where image web parts fail to display correctly after migrating sites to SharePoint Online.

How to Fix Broken Image Web Parts After SharePoint Online Migration
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.
Before you start

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.

Solution 1Recommended

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.

1
Test on the current page

Click 'Edit' on the affected SharePoint page and insert a completely new image web part to see if a newly added image renders properly.

2
Test on a new page

Create a new page within the same SharePoint site directory and insert an image web part to rule out page-level corruption.

3
Verify across different sites

Navigate to a different SharePoint site within your tenant and verify if image web parts work correctly there.

4
Switch browsers and networks

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.

Perform Diagnostic Testing for Web Parts
Diagnostic Outcome: If the new image web part works on a new page but not the migrated one, the specific page layout may have been corrupted during the ShareGate migration.
Free Microsoft Office alternative

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. 1. Download WPS Office: Visit the official WPS website to download the free installation package for your operating system.
  2. 2. Install and Launch: Follow the on-screen prompts to install the lightweight suite and launch the application.
  3. 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.
Highly compatible with Microsoft Office formats including .docx, .xlsx, and .pptx.Lightweight application with fast installation and loading times.Built-in cloud collaboration for easy and secure team document sharing.Familiar user interface requiring no steep learning curve.
microsoft office alternative - wps office

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.