---
title: KentiCopilot content audit and migration
---

> 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).

The [Kentico Migration Tool](https://github.com/Kentico/xperience-by-kentico-kentico-migration-tool) migrates a wide range of content and data from Kentico Xperience 13 (KX13) to Xperience by Kentico (XbyK). However, project requirements often vary. Mapping KX13 features to XbyK, and optionally remodeling content to support a more modern architecture, require significant analysis and development effort.

Thankfully, [KentiCopilot](https://github.com/Kentico/xperience-by-kentico-kenticopilot/tree/main) includes many [migration-related skills](https://github.com/Kentico/xperience-by-kentico-kenticopilot/tree/main/plugins/kentico-kx13-migration/skills) that help you rapidly implement extensions to transform your content according to your needs.

Before watching, we recommend familiarizing yourself with:

- The [high-level process](https://docs.kentico.com/guides/upgrade-to-xbyk/upgrade-from-kx13/upgrade-from-kx13-overview.md) of upgrading from KX13 to Xperience by Kentico
- The [available customization options](https://github.com/Kentico/xperience-by-kentico-kentico-migration-tool/blob/master/docs/Customization-Guide.md) for the [Kentico Migration Tool](https://github.com/Kentico/xperience-by-kentico-kentico-migration-tool)
- The [content modeling best practices](https://docs.kentico.com/guides/architecture/content-modeling/content-modeling-guide.md) of Xperience by Kentico

> **Info:** This page gives a practical overview of KentiCopilot-assisted migration from KX13 to XbyK. Watch the video for a real example, then use the sections below to understand the stages and find the GitHub documentation for detailed setup and execution.\\
>
> This video showcases a migration of the [Medio Clinic](https://github.com/Kentico/xperience-training-13) training site from Kentico Xperience 13. We used _GitHub Copilot_ with the _Claude Opus 4.6_ language model.

🎮 [KentiCopilot - Content audit and migration (interactive demo)](https://demo.arcade.software/haW1WkqLUVIk3bpIQHX5)

> **Tip:** **Choosing a language model**
>
> Many KentiCopilot skills are designed for high-intelligence language models.
>
> We recommend using models with strong reasoning capabilities for KentiCopilot migration skills, especially those related to migration planning and troubleshooting.

## Install and configure the tools

By pointing your agentic coding assistant to the documentation for the [KentiCopilot](https://github.com/Kentico/xperience-by-kentico-kenticopilot/tree/main) and [Kentico Migration Tool](https://github.com/Kentico/xperience-by-kentico-kentico-migration-tool) repositories, you can quickly install and configure the necessary components to start your migration.

Just remember to structure your source and target projects alongside the migration tool in a single workspace, as described in the [plugin documentation](https://github.com/Kentico/xperience-by-kentico-kenticopilot/blob/main/plugins/kentico-kx13-migration/README.md#content-migration).

## Create a migration plan

The first step when migrating with KentiCopilot is to [audit your KX13 content](https://github.com/Kentico/xperience-by-kentico-kenticopilot/blob/main/plugins/kentico-kx13-migration/README.md#content-model-audit) and create a plan.

Your agent will analyze your existing content and suggest data transformations to help it work with XbyK features, along with recommendations for improving your content model.

If the migration requires any manual work before or after execution, such as creating objects in the Xperience admin UI, the migration plan will include instructions. In many cases, the [Management MCP server](https://docs.kentico.com/documentation/developers-and-admins/api/management-api.md) allows your agentic coding assistant to implement these changes for you.

> **Tip:** **Back up your manual changes**
>
> If you manually add objects to the database before migration, we recommend running a continuous integration store and backing up the repository. This allows you to quickly restore objects with the same code names and GUIDs if you decide to start over with a fresh target database.
>
> Otherwise, you may need to adjust GUIDs in the migration plan and/or code files before running another migration attempt against a fresh database.

## Extend the migration tool

Once you have a migration plan, you can use KentiCopilot's skills designed to [extend the migration tool](https://github.com/Kentico/xperience-by-kentico-kenticopilot/blob/main/plugins/kentico-kx13-migration/README.md#content-migration) with the following components:

- [Custom class mappings](https://github.com/Kentico/xperience-by-kentico-kentico-migration-tool/blob/master/docs/customization/Class-Mappings.md) (`IClassMapping`)
- [Custom content item directors](https://github.com/Kentico/xperience-by-kentico-kentico-migration-tool/blob/master/docs/customization/Content-Item-Directors.md) (`ContentItemDirectorBase`)
- [Custom widget migrations](https://github.com/Kentico/xperience-by-kentico-kentico-migration-tool/blob/master/docs/customization/Widget-Migrations.md) (`IWidgetMigration`)
- [Custom widget property migrations](https://github.com/Kentico/xperience-by-kentico-kentico-migration-tool/blob/master/docs/customization/Widget-Property-Migrations.md) (`IWidgetPropertyMigration`)
- [Custom field migrations](https://github.com/Kentico/xperience-by-kentico-kentico-migration-tool/blob/master/docs/customization/Field-Migrations.md) (`IFieldMigration`)
- [customize the entire migration pipeline](https://github.com/Kentico/xperience-by-kentico-kentico-migration-tool/blob/master/docs/customization/Pipeline-Behaviors.md) (`IPipelineBehavior<TRequest, TResponse>`)

In minutes, KentiCopilot can write custom code that might otherwise take hours or days, tailored to fit your content into XbyK.

## Execute, evaluate, and iterate

Once all extensions are in place, use [the run and eval skills](https://github.com/Kentico/xperience-by-kentico-kenticopilot/blob/main/plugins/kentico-kx13-migration/README.md#example-execute-and-evaluate) to run the migration and evaluate the results against the migration plan.

The agent will evaluate the migrated site to determine whether the data aligns with the plan established at the start of the process.

If anything does not migrate according to plan, it will troubleshoot issues, make adjustments, and let you know which skills you may need to rerun.

It may also use the migration tool documentation to implement other types of customization that are not covered by dedicated skills, such as [pipeline behaviors](https://github.com/Kentico/xperience-by-kentico-kentico-migration-tool/blob/master/docs/customization/Pipeline-Behaviors.md).

## Get started with KentiCopilot

You can find detailed instructions for using the migration functionality in the [KentiCopilot repository](https://github.com/Kentico/xperience-by-kentico-kenticopilot/tree/main).

- [Content-model audit skill](https://github.com/Kentico/xperience-by-kentico-kenticopilot/blob/main/plugins/kentico-kx13-migration/README.md#content-model-audit)
- [Content migration skills](https://github.com/Kentico/xperience-by-kentico-kenticopilot/blob/main/plugins/kentico-kx13-migration/README.md#content-migration)
