Add-on upgrades and versions

You should take the following consideration regarding upgrades of your add-on, as well as Sitefinity CMS upgrades:

  • You must mark deprecated functionality and persist it in the code for at least one version.
  • You must announce breaking changes one version prior to introduction.
  • You must list release notes and breaking changes in the <releaseNotes> element of the .nuspec file.
  • Add-ons should have a dependency to an equal or higher version of the first available Sitefinity CMS release that supports the add-on functionality. This will ensure the widest range of possible customers. 
    For more information, see Manage add-on dependencies.

    EXAMPLE: An add-on depends on functionality in Sitefinity CMS that is available from version 9.2.6000. The latest available version of Sitefinity is 10.2.6000. You should add a dependency in the .nuspec file for versions >= 9.2.6000. This way all clients with Sitefinity CMS version higher than 9.2.6000 will be able to use the latest version of the add-on.

  • You must verify add-ons against new major versions of Sitefinity CMS.
    In case of breaking changes, the dependency on Sitefinity CMS must be limited to the last supported version and you must provide a new version of the add-on for the versions, following the breaking changes of Sitefinity CMS.

    EXAMPLE: An add-on has dependency in the .nuspec file for Sitefinity versions >= 9.2.6000. The latest available version of Sitefinity is 10.2.6000 and it introduces a breaking change in the functionality that the add-on depends on. In this case, you should provide a new version of the add-on for the new version of Sitefinity CMS. You should update the old version of the add-on NuGet package to depend on versions >= 9.2.6000 and >10.2.6000.

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

Sample add-ons