# 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](https://www.progress.com/documentation/sitefinity-cms/manage-add-on-dependencies).

  > success  **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.

  > success  **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`.
