Migration Toolkit

✖
Copy to clipboard

Xperience by Kentico Migration Toolkit is a collection of tools developed and supported by Kentico. The aim of these tools is to simplify migration from other systems to Xperience by Kentico. All of the tools listed on this page are part of the Xperience by Kentico offering and are therefore subject to the 7-day bug-fix policy. The tools are not included in the product installation, visit their respective repositories for installation instructions. If you need assistance with any of the tools, see the Support section of the README.md file for each tool.

Xperience by Kentico Migration Toolkit consists of the following migration tools:

  • Kentico Migration Tool - A customizable tool that migrates older Kentico solutions to the latest version of Xperience by Kentico.
  • Sitecore Migration Tool - A customizable tool that migrates Sitecore solutions to Xperience by Kentico.
  • Sitefinity Migration Tool - A customizable tool that migrates Sitefinity solutions to Xperience by Kentico.
  • Universal Migration Tool - Underlying technology to enable content and data imports from any data source into Xperience by Kentico.

You can also customize the tools on top of their out-of-the-box functionality to make them fit your specific migration needs.

Overview of the XbyK Migration Toolkit

Kentico Migration Tool

The Xperience by Kentico: Kentico Migration Tool enables you to migrate database content and other data from older Kentico versions to Xperience by Kentico. Currently supported versions of the source instance are Kentico Xperience 13, Kentico 12, and Kentico 11.

Due to differences in the feature set of the products, the Kentico Migration Tool cannot transfer all data available in the older Kentico versions. Certain types of data are migrated to a suitable alternative or discarded.

The Kentico Migration Tool migrates content and objects stored in the database along with related binary data on the file system, such as media library files.

The following diagram showcases all available upgrade paths to get from older Kentico versions to Xperience by Kentico using Kentico upgrade tools, community conversion tools and the Kentico Migration Tool. You can read more about the community conversion tool in our blog.

Overview of available Kentico upgrade tools

  • Kentico 13:
    • Use Kentico Migration Tool to migrate structured content and Page Builder content to Xperience by Kentico.
  • Kentico 12 MVC offers two options:
    • Use Kentico Migration Tool to migrate structured content to Xperience by Kentico.
    • Use the Kentico upgrade tools to upgrade to Kentico 13 and then use Kentico Migration Tool to migrate structured content and Page Builder content to Xperience by Kentico.
  • Kentico 12/11/10 Portal Engine offer two options:
    • Use Kentico Migration Tool to migrate structured content to Xperience by Kentico.
    • Use the Kentico upgrade tools to upgrade to Kentico 12 Portal Engine if migrating from Kentico 11/10. Then use the Kentico Xperience 12 Portal to Kentico Xperience 13 Converter community tool to upgrade to Kentico 13. Finally, use Kentico Migration Tool to migrate structured content and Page Builder content to Xperience by Kentico.

Code, customizations, and any unsupported content need to be manually transferred to the target Xperience by Kentico solution and adjusted for Xperience by Kentico’s architecture and API differences.

For more information and detailed instructions, see the Xperience by Kentico: Kentico Migration Tool GitHub repository.

Sitecore Migration Tool

The Xperience by Kentico: Sitecore Migration Tool enables you to automatically export data from Sitecore and import it to your Xperience by Kentico instance using a custom module in the administration interface.

Sitecore Migration Tool diagram

For more information and detailed instructions, see the Xperience by Kentico: Sitecore Migration Tool GitHub repository.

Sitefinity Migration Tool

The Xperience by Kentico: Sitefinity Migration Tool enables you to automatically export data from Sitefinity and import it to your Xperience by Kentico instance using a custom module in the administration interface.

Sitefinity Migration Tool diagram

For more information and detailed instructions, see the Xperience by Kentico: Sitefinity Migration Tool GitHub repository.

Universal Migration Tool

The Xperience by Kentico: Universal Migration Tool is a set of libraries, documentation, and samples that enable you to export data from external systems (legacy Kentico versions, other CMS systems) and automatically import it to your Xperience by Kentico instance.

You can either create a JSON document according to our specifications using a technology of your choice or use our .NET library to build your own C# models which represent the JSON structure. The integration also includes a custom module application for the Xperience administration, enabling users to upload the imported JSON files directly through the application’s user interface.

Universal Migration Tool diagram

For more information and detailed instructions, see the Xperience by Kentico: Universal Migration Tool GitHub repository.

Customize the migration tools

The migration tools are designed to cover the most common migration cases and help streamline the process of transferring a project to Xperience by Kentico. Since implementation details and content models vary from project to project, the migration tools may not always fully align with your requirements. The tools are open-source for this reason – you can customize them or even create your own tools based on the Universal Migration Tool.

If you are upgrading from Kentico Xperience, you can extend the Kentico Migration Tool with the use of the Migration.Tool.Extensions module. The module enables you to remap and optimize the original content model to the new content model recommended for Xperience by Kentico, remodel widgets, migrate page types to reusable field schemas and more.