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.
- Remove your extensions from their old configuration locations (taking care to back up how you configured them)
- Create one or more Add-on packages (ZIP files) containing one or more Extensions each (applying the same configuration)
- Add a manifest file to each package.
- Upload the packages to the product using the Add-ons screen in Content Manager Explorer.
| Extension | Path to configuration file (relative to %TRIDION_HOME%) | Configuration location |
|---|---|---|
| Event Handler | config\Tridion.Content.Manager.config | <extensions> section |
| Custom Resolver | config\Tridion.Content.Manager.config | <resolving> section |
| GUI extension | web\WebUI\WebRoot\Configuration\System.config | <Editors> or <Models> section (or both) |
- 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.