--- title: UCOMMERCE MIGRATION Guide from Classic to Next Gen description: Discover how to migrate from Ucommerce Classic to Ucommerce Next Gen. This guide aims to distill complex information into precise, actionable steps! image: https://ucommerce.net/hubfs/migration_2_1-1.png --- [Skip to content](https://ucommerce.net/news/ucommerce-nextgen-migration#main-content) Close - [Product](https://ucommerce.net/product) - [Integrated PIM System](https://ucommerce.net/integrated-pim-system) - [B2B Price Engine](https://ucommerce.net/advanced-b2b-price-engine) - [Powerful Search](https://ucommerce.net/search) - [Sitefinity X Ucommerce](https://ucommerce.net/sitefinity) - [Umbraco X Ucommerce](https://ucommerce.net/umbraco) - [Sitecore X Ucommerce](https://ucommerce.net/sitecore) - [Pricing](https://ucommerce.net/pricing) - [Customers](https://ucommerce.net/customers) - [Partners](https://ucommerce.net/partners) - [Support](https://ucommerce.net/support) - [Insights](https://ucommerce.net/insights) - [Webinars](https://ucommerce.net/news/tag/webinars) - [News](https://ucommerce.net/news) - [Documentation](https://dev.ucommerce.net/) SEARCH Contact Us [![ucommerce-widelogo](https://ucommerce.net/hubfs/Logos/Ucommerce%20logos/ucommerce-widelogo.svg)](https://ucommerce.net) - [Product](https://ucommerce.net/product) - [Integrated PIM System](https://ucommerce.net/integrated-pim-system) - [B2B Price Engine](https://ucommerce.net/advanced-b2b-price-engine) - [Powerful Search](https://ucommerce.net/search) - [Sitefinity X Ucommerce](https://ucommerce.net/sitefinity) - [Umbraco X Ucommerce](https://ucommerce.net/umbraco) - [Sitecore X Ucommerce](https://ucommerce.net/sitecore) - [Pricing](https://ucommerce.net/pricing) - [Customers](https://ucommerce.net/customers) - [Partners](https://ucommerce.net/partners) - [Support](https://ucommerce.net/support) - [Insights](https://ucommerce.net/insights) - [Webinars](https://ucommerce.net/news/tag/webinars) - [News](https://ucommerce.net/news) - [Documentation](https://dev.ucommerce.net/) Contact Us Quick results for "{search\_term}" ![ebooks_herobanner3](https://ucommerce.net/hubfs/ebooks_herobanner3.svg) 3 min read # UCOMMERCE MIGRATION Guide from Classic to Next Gen [Previous](https://ucommerce.net/news/ucommerce-next-gen-version-10.2.0) [Next](https://ucommerce.net/news/ucommerce-nextgen-version-10.3.0) ## Ucommerce Classic → Ucommerce Next Gen Are you currently using Ucommerce V9 and considering an upgrade? You're in the right place! If you are not on V9 and you're considering upgrading, we recommend contacting us. We'll help devise a plan to ensure a smooth migration.    Upgrading can seem daunting due to its comprehensive nature and the numerous steps involved, but it’s worthwhile. We promise! The following post will contain a guide to walk you through everything you need to know about the upgrade process. We'll cover the essential steps, common pitfalls to avoid, and best practices to ensure a smooth transition to the latest version of Ucommerce. ### We're here to help you! ### Before you migrate Before you begin the migration process. Here are a few things you should consider: #### Contact us When migrating it is crucial to get it right from the start. Therefore, We strongly recommend consulting one of our experts to review your specific needs to ensure a solid point of departure for a smooth transition.   #### Prerequisites Before beginning, make sure you have the following installed: -  .NET SDK 8 -  Latest Ucommerce 9 (for migrations only) -  \* [SQL Server Compatibility level 130](https://learn.microsoft.com/en-us/sql/t-sql/statements/alter-database-transact-sql-compatibility-level?view=sql-server-ver16#compatibility_level--160--150--140--130--120--110--100--90--80-) or higher -  \* Elastic Server 8.11.0 or newer. -  \* Docker \* When using the In-Process template, you can optionally use Docker. This eliminates the need for an SQL and Elastic Server on your machine. ### Migration - let's do this! Okay, so you're good to go. You have contacted us if you have any complex custom code and made sure you have all prerequisites in place. #### 1. Migrate your database To begin, upgrade your database to the latest release of Ucommerce 9. If your setup already includes Ucommerce 9, you can simply update your Ucommerce package and restart your application to proceed. For those using SQL Server, ensure that your database is set to a SQL Server compatibility level of at least 130 to guarantee smooth operation. #### 2. Install Ucommerce Next Gen with Templates For an easy installation of Ucommerce Next Gen, we recommend using our ready-made templates. Details and download options can be found [here](https://dev.ucommerce.net/ucommerce-next-gen/getting-started/ucommerce-templates). After creating a new project with one of the templates, add your database connection string. Once set up, launch the project to automatically initiate the database migration. Finally, visit the Ucommerce backoffice at `/ucommerce` to confirm that your data has been successfully migrated. #### 3. Migrating custom logic Start by identifying the custom-built components of your Ucommerce Classic solution. Key differences to be aware of include modifications in dependency injection, application setup, database access, and pipeline registration. For more specific guidance on migrating custom logic, check out these articles from our documentation: -  [Discover pipelines and their tasks](https://dev.ucommerce.net/ucommerce-next-gen/how-to/discover-pipelines-and-their-tasks) -  [Extending Pipelines](https://dev.ucommerce.net/ucommerce-next-gen/extensions/extending-pipelines) -  [Change Service Behaviour](https://dev.ucommerce.net/ucommerce-next-gen/extensions/change-service-behavior) -  [Entities from code](https://dev.ucommerce.net/ucommerce-next-gen/how-to/entities-from-code) -  [Custom UI Components](https://dev.ucommerce.net/ucommerce-next-gen/extensions/extend-the-backoffice/custom-ui-components) ### Developer love from Ucommerce ❤️ Ucommerce Next Gen equips your development team with cutting-edge frameworks, tools, and best practices, all built on the robust .NET 8 platform. This adoption utilizes EF Core for optimized database management and superior data handling. Our commitment to the latest Microsoft technologies not only facilitates smoother integration and faster adoption but also allows for extensive customization of the UI with any logic you choose. The platform's close alignment with .NET's own technologies enhances developer familiarity, significantly reducing project timelines and streamlining your upgrade process. Happier developers mean more efficient projects! Check out our [product page](https://ucommerce.net/product) for more insights.   ![avatar](https://ucommerce.net/hs-fs/hubfs/Casper%20author.png?width=290&name=Casper%20author.png) #### [Casper Schmidt Wandahl-Liper](https://ucommerce.net/news/author/casper-schmidt-wandahl-liper) Senior Backend Engineer at Ucommerce [mailto:casper.schmidt.wandahl-liper@ucommerce.dk](mailto:casper.schmidt.wandahl-liper@ucommerce.dk) ## MORE SUCCESS STORIES All Success Stories [![ucommerce-widelogo](https://139731713.fs1.hubspotusercontent-eu1.net/hubfs/139731713/Logos/Ucommerce%20logos/ucommerce-widelogo.svg)](https://ucommerce.net) The Leading .NET Based Enterprise E-commerce Platform - [Product](https://ucommerce.net/product) - [Product Update Webinars](https://ucommerce.net/news/tag/webinars) - [Release Notes](https://ucommerce.net/release-notes) - [Knowledge Base](https://ucommerce.net/support) - [Support](https://ucommerce.net/support) - [Contact](https://ucommerce.net/support) - [Ucommerce Classic Documentation](http://docs.ucommerce.net/) - [Ucommerce Next Gen Documentation](http://dev.ucommerce.net/) - [Academy](https://ucommerce.net/academy) - [Pricing](https://ucommerce.net/pricing) All rights reserved - [Privacy Policy](https://ucommerce.net/data-privacy-and-cookie-policy) - [Cookies](https://ucommerce.net/data-privacy-and-cookie-policy) - [Terms & Conditions](https://ucommerce.net/data-privacy-and-cookie-policy) ```json { "@context" : "https://schema.org", "@type" : "Organization", "address" : { "@type" : "PostalAddress", "addressCountry" : "Denmark", "addressLocality" : "Aarhus V", "addressRegion" : "Denmark", "postalCode" : "8210", "streetAddress" : "Rymarken 2" }, "knowsLanguage" : "en", "logo" : { "@type" : "ImageObject", "url" : "https://139731713.fs1.hubspotusercontent-eu1.net/hubfs/139731713/Ucommerce%20and%20CMS%20Logo/Ucommerce%20logos/ucommerce-widelogo.svg" }, "name" : "Ucommerce ApS", "url" : "https://ucommerce.net/news/ucommerce-nextgen-migration" } ``` ```json { "@context" : "https://schema.org", "@type" : "BlogPosting", "abstract" : "Discover how to migrate from Ucommerce Classic to Ucommerce Next Gen. This guide aims to distill complex information into precise, actionable steps!", "author" : { "@type" : "Person", "name" : "Casper Schmidt Wandahl-Liper" }, "dateModified" : "January 31, 2025 9 AM", "datePublished" : "May 29, 2024 9 AM", "headline" : "UCOMMERCE MIGRATION Guide from Classic to Next Gen", "image" : "https://139731713.fs1.hubspotusercontent-eu1.net/hubfs/139731713/migration_2_1-1.png", "inLanguage" : "en", "keywords" : "[Product News]", "mainEntityOfPage" : { "@type" : "WebPage" }, "name" : "UCOMMERCE MIGRATION Guide from Classic to Next Gen", "publisher" : { "@type" : "Organization", "logo" : { "@type" : "ImageObject", "url" : "https://139731713.fs1.hubspotusercontent-eu1.net/hubfs/139731713/Ucommerce%20and%20CMS%20Logo/Ucommerce%20logos/ucommerce-widelogo.svg" }, "name" : "Ucommerce ApS" }, "text" : "Ucommerce Classic → Ucommerce Next Gen Are you currently using Ucommerce V9 and considering an upgrade? You're in the right place! If you are not on V9 and you're considering upgrading, we recommend contacting us. We'll help devise a plan to ensure a smooth migration. Upgrading can seem daunting due to its comprehensive nature and the numerous steps involved, but it’s worthwhile. We promise! The following post will contain a guide to walk you through everything you need to know about the upgrade process. We'll cover the essential steps, common pitfalls to avoid, and best practices to ensure a smooth transition to the latest version of Ucommerce. We're here to help you! Before you migrate Before you begin the migration process. Here are a few things you should consider: Contact us When migrating it is crucial to get it right from the start. Therefore, We strongly recommend consulting one of our experts to review your specific needs to ensure a solid point of departure for a smooth transition. Prerequisites Before beginning, make sure you have the following installed: .NET SDK 8 Latest Ucommerce 9 (for migrations only) * SQL Server Compatibility level 130 or higher * Elastic Server 8.11.0 or newer. * Docker * When using the In-Process template, you can optionally use Docker. This eliminates the need for an SQL and Elastic Server on your machine. Migration - let's do this! Okay, so you're good to go. You have contacted us if you have any complex custom code and made sure you have all prerequisites in place. 1. Migrate your database To begin, upgrade your database to the latest release of Ucommerce 9. If your setup already includes Ucommerce 9, you can simply update your Ucommerce package and restart your application to proceed. For those using SQL Server, ensure that your database is set to a SQL Server compatibility level of at least 130 to guarantee smooth operation. 2. Install Ucommerce Next Gen with Templates For an easy installation of Ucommerce Next Gen, we recommend using our ready-made templates. Details and download options can be found here. After creating a new project with one of the templates, add your database connection string. Once set up, launch the project to automatically initiate the database migration. Finally, visit the Ucommerce backoffice at /ucommerce to confirm that your data has been successfully migrated. 3. Migrating custom logic Start by identifying the custom-built components of your Ucommerce Classic solution. Key differences to be aware of include modifications in dependency injection, application setup, database access, and pipeline registration. For more specific guidance on migrating custom logic, check out these articles from our documentation: Discover pipelines and their tasks Extending Pipelines Change Service Behaviour Entities from code Custom UI Components Developer love from Ucommerce ❤️ Ucommerce Next Gen equips your development team with cutting-edge frameworks, tools, and best practices, all built on the robust .NET 8 platform. This adoption utilizes EF Core for optimized database management and superior data handling. Our commitment to the latest Microsoft technologies not only facilitates smoother integration and faster adoption but also allows for extensive customization of the UI with any logic you choose. The platform's close alignment with .NET's own technologies enhances developer familiarity, significantly reducing project timelines and streamlining your upgrade process. Happier developers mean more efficient projects! Check out our product page for more insights.", "url" : "https://ucommerce.net/news/ucommerce-nextgen-migration", "wordCount" : "1803" } ``` ```json { "@context" : "https://schema.org", "@type" : "BlogPosting", "author" : { "@type" : "Person", "name" : "Casper Schmidt Wandahl-Liper", "url" : "https://ucommerce.net/news/author/casper-schmidt-wandahl-liper" }, "dateModified" : "2025-01-31T09:49:15.448Z", "datePublished" : "2024-05-29T09:27:18.000Z", "headline" : "UCOMMERCE MIGRATION Guide from Classic to Next Gen", "image" : [ "https://ucommerce.net/hubfs/migration_2_1-1.png" ], "mainEntityOfPage" : { "@id" : "https://ucommerce.net/news/ucommerce-nextgen-migration", "@type" : "WebPage" }, "publisher" : { "@type" : "Organization", "logo" : { "@type" : "ImageObject", "url" : "https://ucommerce.net/hubfs/Ucommerce%20and%20CMS%20Logo/Ucommerce%20logos/ucommerce-widelogo.svg" }, "name" : "Ucommerce Aps" } } ```