---
title: Upgrade deep dives for developers
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

No two project upgrades are the same, but diving into more technical example scenarios will help you familiarize yourself with the available tools.

These scenarios highlight more advanced use cases than those covered in the [upgrade walkthrough](https://docs.kentico.com/guides/upgrade-to-xbyk/upgrade-walkthrough.md) from the [Architecture guides](https://docs.kentico.com/guides/architecture.md).

> **Tip:** If you haven't already seen our [upgrade overview materials](https://docs.kentico.com/guides/upgrade-to-xbyk/upgrade-from-kx13.md) and followed the [basic walkthrough](https://docs.kentico.com/guides/upgrade-to-xbyk/upgrade-walkthrough.md), we recommend checking them out before these guides.

> **Info:** 
>
> ## Start here
>
> Get oriented with project structure, scenario planning, and navigation to the right techniques.
>
> > **Tip:** _KentiCopilot_ includes [ `kentico-kx13-migration plugin`](https://github.com/Kentico/xperience-by-kentico-kenticopilot/tree/main/plugins/kentico-kx13-migration/skills) that package the customization patterns described across these deep dives. The `kentico-kx13-migration` plugin helps you [generate](https://github.com/Kentico/xperience-by-kentico-kenticopilot/blob/main/plugins/kentico-kx13-migration/README.md) a project-specific migration plan, using it to create configuration files, extensions to the migration tool, and live-site codebase updates. See the [KX13 upgrade hands-on assistance](https://docs.kentico.com/guides/development/kenticopilot.md#kx13-upgrade-hands-on-assistance) section for more details.
>
> ---
>
> [Navigate advanced upgrades](https://docs.kentico.com/guides/upgrade-to-xbyk/upgrade-deep-dives/navigate-the-upgrade-development.md)
>
> **CONCEPT**
>
> Navigate advanced upgrade scenarios through a decision tree that matches your specific needs to the right implementation guides.
>
> ---

> **Info:** 
>
> ## Evolve your content model
>
> Bring your content into the modern era by restructuring your data for newer architecture.
>
> ---
>
> [Remodel page types as reusable field schemas](https://docs.kentico.com/guides/upgrade-to-xbyk/upgrade-deep-dives/remodel-page-types-as-reusable-field-schemas.md)
>
> **HOW-TO**
>
> Transform your content model to take advantage of new features like [\*reusable field schemas\*](https://docs.kentico.com/documentation/developers-and-admins/development/content-types/reusable-field-schemas.md) while you migrate data from Kentico Xperience 13 to Xperience by Kentico.
>
> ---
>
> [Speed up remodeling with AI](https://docs.kentico.com/guides/upgrade-to-xbyk/upgrade-deep-dives/speed-up-remodeling-with-ai.md)
>
> **CONCEPT**
>
> See how agentic AI coding assistants can accelerate the process of remodeling content types and field mappings during your upgrade. Learn how to provide the best context and instructions for the highest quality results.
>
> ---
>
> [Migrate page SKU data into Xperience](https://docs.kentico.com/guides/upgrade-to-xbyk/upgrade-deep-dives/migrate-page-sku-data.md)
>
> **HOW-TO**
>
> Migrate SKU data alongside page type fields from Kentico Xperience 13 into Xperience by Kentico, creating and referencing SKU variants and media file images from parent products.
>
> ---
>
> [Transfer parent-child page hierarchy to the Content hub](https://docs.kentico.com/guides/upgrade-to-xbyk/upgrade-deep-dives/transfer-page-hierarchy-to-content-hub.md)
>
> **HOW-TO**
>
> Modernize your content without losing page hierarchy by creating automatic relationships between reusable items as you migrate them to the Content hub.
>
> ---

> **Info:** 
>
> ## Work with widgets during upgrade
>
> Give your editors the tools they need for flexible, eye-catching pages, modernizing widgets to work with newer content models.
>
> ---
>
> [Upgrade widgets from Kentico Xperience 13](https://docs.kentico.com/guides/upgrade-to-xbyk/upgrade-deep-dives/upgrade-widgets-introduction.md)
>
> **CONCEPT**
>
> Explore your options for migrating widgets from KX13 to XbyK, looking at data transfer strategies and modernization best practices.
>
> ---
>
> [Migrate widget data as reusable content](https://docs.kentico.com/guides/upgrade-to-xbyk/upgrade-deep-dives/migrate-widget-data-to-content-hub.md)
>
> **HOW-TO**
>
> Transform KX13 widget data into reusable Content hub items using custom widget migration to modernize your architecture during your XbyK upgrade.
>
> ---
>
> [Transform widget properties](https://docs.kentico.com/guides/upgrade-to-xbyk/upgrade-deep-dives/transform-widget-properties.md)
>
> **HOW-TO**
>
> Transform widget properties during your KX13 to XbyK upgrade; migrate UI controls, restructure properties, and handle custom components.
>
> ---
>
> [Convert child pages to widget content](https://docs.kentico.com/guides/upgrade-to-xbyk/upgrade-deep-dives/convert-child-pages-to-widgets.md)
>
> **HOW-TO**
>
> Convert child pages into flexible Page Builder widgets, transforming page tree content into reusable Content hub items that editors can manage through a drag-and-drop interface.
>
> ---
>
> [Migrate widget-collection relationships](https://docs.kentico.com/guides/upgrade-to-xbyk/upgrade-deep-dives/migrate-widget-collection-relationships.md)
>
> **CONCEPT**
>
> Learn how to migrate collection-based widget scenarios in Xperience by Kentico. This guide explains four recommended strategies and helps you choose the one that best fits your project’s content model, editorial needs, and long-term architecture.
>
> ---

> **Info:** 
>
> ## Use other new Xperience features
>
> Explore some of Xperience's other cutting-edge features and how to apply them in your upgraded project.
>
> ---
>
> [Optimize images during your upgrade](https://docs.kentico.com/guides/upgrade-to-xbyk/upgrade-deep-dives/optimize-images-during-upgrade.md)
>
> **HOW-TO**
>
> Ensure lightning-fast images by configuring the _Kentico migration tool_ to use Xperience's automatic image optimization feature for media library files and page attachments.
>
> ---
>
> [Upgrade your content retrieval code](https://docs.kentico.com/guides/upgrade-to-xbyk/upgrade-deep-dives/upgrade-content-retrieval.md)
>
> **HOW-TO**
>
> Convert your content retrieval code from `IPageRetriever`,  `DocumentHelper`, and `TreeProvider` patterns to modern XbyK APIs with practical examples from real KX13 scenarios.
>
> ---