Topics

All topics

Upgrade procedure

Upgrade prerequisites
PREREQUISITES: Before you upgrade your Sitefinity CMS, ensure the following:
  • You have backed up your project and its database.
  • You are familiar with the API changes for the Sitefinity CMS release you are upgrading to. For more information, see API breaking changes in Sitefinity CMS.
  • You have upgraded your Microsoft .NET framework to the respective version.
    For more information, see Reference: Sitefinity CMS and .NET framework compatibility.
  • Your project is not located in a folder that has any special characters in the name, such as ~\Program Files (x86).

Upgrade paths
You must use the following upgrade paths, depending on your current Sitefinity CMS version:
  • If your project is on Sitefinity CMS 10.0 or above, you must use Sitefinity CLI to upgrade.
    Sitefinity CLI upgrades the project and installs the NuGet packages automatically and has the following advantages:
    • CLI automatically handles broken or missing references
    • The target framework of the upgraded project is automatically set to the relevant Sitefinity CMS framework version.
    • The CLI automatically fixes binding redirects
    • All Sitefinity projects in the solution are automatically upgraded without the need to manually go through them. 
    • You can include it as a step in a Continuous integration pipeline.
  • If your project is on Sitefinity CMS 8.0 to 9.2, you must use NuGet package to upgrade.
    By updating the version of Telerik.Sitefinity.All package, you upgrade all Sitefinity CMS related packages in your projects.
    As of Sitefinity CMS version 11.0 NuGet takes care of updating the project references and applying the necessary web.config changes automatically. If upgrading to version prior to 11.0 you must take care of these changes manually.
  • If your project in on Sitefinity CMS 7.3 or below, you must use the 8.0 version of the Project Manager to upgrade it to Sitefinity CMS 8.0, then upgrade it to 8.1 and above using the NuGet package.
    The Project Manager adds the new assemblies to the bin folder, and also offers the option to automatically upgrade your web.config file and assembly references.

Upgrade version

RECOMMENDATION: We recommend that you always upgrade to the latest version. 
However, you may want to upgrade to any other version. For example, you may want to upgrade from Sitefinity CMS 13.2 to 14.0.

Upgrade Sitefinity .NET Core Renderer

IMPORTANT: If you are using Sitefinity CMS as a headless CMS with Sitefinity .NET Core Renderer, in addition to upgrading Sitefinity CMS, you must upgrade the .NET Core Renderer as well.

For more information, see Upgrade Sitefinity .NET Core Renderer.

Want to learn more?

Increase your Sitefinity skills by signing up for our free trainings. Get Sitefinity-certified at Progress Education Community to boost your credentials.

Get started with Integration Hub | Sitefinity Cloud | Sitefinity SaaS

This free lesson teaches administrators, marketers, and other business professionals how to use the Integration hub service to create automated workflows between Sitefinity and other business systems.

Web Security for Sitefinity Administrators

This free lesson teaches administrators the basics about protecting yor Sitefinity instance and its sites from external threats. Configure HTTPS, SSL, allow lists for trusted sites, and cookie security, among others.

Foundations of Sitefinity ASP.NET Core Development

The free on-demand video course teaches developers how to use Sitefinity .NET Core and leverage its decoupled architecture and new way of coding against the platform.

Was this article helpful?

Next article

Upgrades in Continuous delivery