How to Fix SharePoint XML Web Part Errors After Tenant Migration
Question details
Users experience XML web part errors or cannot insert app web parts on SharePoint subsites following a tenant migration.
- Product
- Microsoft SharePoint
- Device & OS
- not provided
- Scenario
- Accessing, configuring, or editing web parts on a SharePoint site and its subsites after completing a tenant migration.
- Observed behavior
- Classic list web parts fail to load or cannot be added to subsites, and SharePoint Designer menus are missing or appear different than they did before the migration.
Verify your current site architecture to determine if the migration transitioned your site from a classic SharePoint template to a modern SharePoint experience.
Replace Unsupported Classic Web Parts with the Embed Web Part
Modern SharePoint sites do not support certain classic list web parts or XML customizations. Using the Embed web part via an iframe is the recommended workaround for displaying subsite content.
If your site was migrated from a classic template to a modern SharePoint experience, legacy XML-based components and certain app web parts will no longer function natively. Microsoft recommends using the Embed web part to bridge this gap.
Navigate to the modern SharePoint subsite where you want to display the content. Click 'Edit' in the top right corner of the page.
Hover your cursor over the page canvas and click the '+' icon to open the web part menu. Search for and select the 'Embed' web part.
In the property pane on the right, paste an iframe code snippet pointing to the list or content URL located on the parent site.
Review the embedded content to ensure it displays correctly, then click 'Republish' or 'Publish' to save your page.
Investigate Configuration Changes with Migration Administrators
If the migration was strictly between modern sites without a template change, the errors might stem from underlying configuration discrepancies.
Try WPS Office for Seamless Document Management
While SharePoint handles complex site migrations and web part architecture, managing your everyday office documents shouldn't be a hassle. WPS Office offers a free, lightweight, and highly compatible alternative to Microsoft Office, letting you easily handle documents, spreadsheets, and presentations with a familiar interface.
- 1. Download the Installer: Visit the official WPS website and download the free installation package for your operating system.
- 2. Install and Launch: Run the installer, follow the on-screen prompts, and open the application.
- 3. Open Your Documents: Instantly open and edit your existing Word, Excel, or PowerPoint files without any format loss or layout issues.
Frequently Asked Questions
Why did my SharePoint Designer menus change after the migration?
A migration can alter your site template, particularly if transitioning from classic to modern SharePoint. Modern sites feature restricted SharePoint Designer capabilities, inherently removing many menus and options that were previously used for classic XML customization.
Can I still use classic list web parts on a modern SharePoint site?
No, modern SharePoint sites do not natively support classic list web parts or legacy XML-based components. You must utilize modern equivalents, such as the Embed web part, to display legacy content.
How do I show parent site content on a subsite in modern SharePoint?
You can display parent site content on a subsite by adding the Embed web part to the modern page. Within its properties, insert an iframe code that directly points to the URL of the parent site's list or library.
