Sitecore Content and Layout Migration Part 1: Layout Manager Pro
Content migrations rarely fail because of text or images. Pushing fields like titles and body text through an API or serialization is straightforward. The real headache starts when you open the page in SitecoreAI Page builder and realize everything looks completely broken.
Components are in the wrong order, datasources point to nowhere, or the page completely breaks due to a corrupt placeholder path. In a serious migration, it is not just about the data, it is all about the presentation details.
In this first part of my series on complex migrations, we will look at the harsh reality of Layout XML and how my tool, Layout Manager Pro, helps you tame this chaos.
Why migrations break on Layout XML When you migrate pages, you are manipulating complex XML under the hood (__Renderings and __Final Renderings). For a simple lift and shift, the damage is usually limited. But if you are moving to a modern set of components? The complexity goes through the roof:
Component Splitting: One source component needs to be split into multiple target components, or the other way around.
Logic-based Mapping: Migration rules based on rendering parameters determine which new component should be created with specific rendering parameters. Note: the Agent API does not support setting rendering parameters at the moment, so you are definitely entering advanced territory here.
Shared vs Final: The risk that language-specific overrides in the Final layout get permanently merged into your Shared layout, including the challenge of keeping the right order and merge logic.
Soft Deletes: Components that were logically deleted in the source environment (soft delete markers) should not accidentally come back to life in your new environment.
Personalization: The rendering XML can contain personalization rules. Layout Manager Pro takes this into account. During a migration, you have to choose: ignore and filter them out, or migrate them. The difference between XP and the new AI-driven world (XM Cloud) is significant here.
Without visual help, debugging this XML puzzle is a nightmare. That is exactly why I built Layout Manager Pro.
Watch the Demos To quickly see the tool in action, I have two videos ready for you:
1. General Introduction to Layout Manager Pro In this video, you will see the basics: how to use the extension within the SitecoreAI Page builder context to get instant insight into your item structure.
2. Working with Rendering Parameters Parameters are usually the place where migrations subtly go wrong. I will show you how to analyze parameters and how the tool helps you quickly find GUIDs and spot missing items. Because these parameters are encoded and hard to read in raw XML, Layout Manager Pro is incredibly useful here.
The Toolkit for Migration Experts As the creator, I added features specifically designed to solve the frustrations you face during a migration run:
XML Inspection & Validation: Copy, edit, and validate XML directly. See at a glance whether a rendering comes from the Standard Values, the Shared layout, or the Final layout.
GUID Analysis: No more searching around in the Content Editor. See instantly if a datasource item actually exists or if you are pointing to a "ghost" item.
Parameter Guides: Help with name conversions so you can easily check if a value from the source arrived correctly in the target.
Placeholder Structure: Get a clear grip on your DynamicPlaceholderIds and complex nested placeholder structures.
Sneak Peek: What is coming next? (Features in Progress) I am currently working on one of the most requested, yet highly complex features: the Placeholder Checker.
During a migration, it often happens that a rendering is created inside a placeholder tha due to a mistake in nesting or namin is not actually visible on the page. The component "exists" in the XML, but it is invisible to the user. The Placeholder Checker will flag this instantly. You will immediately see which component is "floating" and where the hierarchy is broken. This will massively shorten the debug time for complex nested column structures.
What to expect in this series This blog is the start of a series where I share my experiences building migration tooling and running large-scale projects:
Tooling Part 1: Layout Manager Pro (Today).
Tooling Part 2 & 3: Other essential tools in your arsenal.
Migration Experiences: Real-world lessons, complex mapping scenarios, and tips to make your scripts faster and safer.
Are you working on a Sitecore migration? Install Layout Manager Pro via the Sitecore Marketplace and let me know which features would make your job easier!
