Migration to the new Add-on feature

The Add-on feature, introduced in SDL Tridion Sites 9.1, lets you combine one or more extensions to the product to form an Add-on package, representing a complete functional addition to the product, called an Add-on. If you are upgrading, SDL recommends that you migrate your existing extensions into one or more such Add-on packages.

If you upgrade from an older version than SDL Tridion Sites 9.1, your existing Content Manager extensions (for example, GUI extensions or Event Handlers) will continue to work. But the way they are deployed is now deprecated.

SDL recommends that you migrate your extension in the following way:
  1. Remove your extensions from their old configuration locations (taking care to back up how you configured them)
  2. Create one or more Add-on packages (ZIP files) containing one or more Extensions each (applying the same configuration)
  3. Add a manifest file to each package.
  4. Upload the packages to the product using the Add-ons screen in Content Manager Explorer.
You can find the configurations for your extensions in the following locations:
ExtensionPath to configuration file (relative to %TRIDION_HOME%)Configuration location
Event Handlerconfig\Tridion.Content.Manager.config<extensions> section
Custom Resolverconfig\Tridion.Content.Manager.config<resolving> section
GUI extensionweb\WebUI\WebRoot\Configuration\System.config<Editors> or <Models> section (or both)
The new Add-on feature makes it easier to manage your extensions:
  • Extensions that are functionally interdependent (for example, a GUI extension and an Event Handler that jointly add some functionality to Content Manager) can be combined into a single Add-on.
  • Managing Add-ons (uploading, updating, configuring with a separate configuration file) is more user-friendly thanks to the Add-ons user interface.

Refer to the installation and implementation documentation for Add-ons for more information.