With the 5.10 release, a new transcode system is introduced.
The new transcode system has been written from scratch and is much easier to configure than the old transcode system. The main capabilities of the new transcode system are described here.
When upgrading existing environments to 5.10, the new transcode system is automatically used as much as possible. The old transcode system can still be used in 5.10 but will be deprecated in later releases. Thus, it is highly advised to fully use the new transcode system instead of the old transcode system as soon as possible.
This page describes the main things to be aware of when migrating to the new transcode system.
Automatic migration
When upgrading to 5.10, as many old media formats as possible are automatically migrated to new formats. In particular, a new format with the same name as the old format is created, and then the old format is mapped to the new format. This is only done for old media formats that can be mapped to a supported format type in the new transcode system. Please contact RnD if you have a use case for a format type that is not supported in the new transcode system.
An overview of all formats can be seen in the system administration page in the Media Manager. If a format is mapped to an old media format, this can be seen in the “Mapped media formats” parameter when viewing the details of a format.
When an old media format is mapped to a new format, please be aware of the following:
All changes to the old media format are ignored.
Existing renditions are not re-generated. Thus, the existing renditions will be used when requesting renditions of existing assets in the new format. This is also the case if generating the rendition with the new format definition would lead to a different rendition than the existing rendition.
For new assets, the new transcode system and the new format is used to generate renditions. This is also the case if a rendition of the old media format is requested.
Renditions of the format can still be requested with the id of the old media format. This is mainly relevant for backward-compatibility reasons.
New thumbnail formats
With the 5.10 release, the thumbnail and preview formats that are defined out of the box have been reworked. By default, this is handled automatically and no manual actions are required.
The main difference between the old and the new thumbnail formats is that they are now webp files with transparency. The old thumbnails were jpeg files without transparency.
As described above, the thumbnails for existing assets are not automatically re-generated. If the existing thumbnails should be re-generated, this can be done by setting up an automation that uses the “Generate asset renditions” step with the “Force generate” flag enabled.
Things to be aware of
After updating to 5.10, at most 200 new old media formats can be created. If you need to create an old media format after upgrading to 5.10, please reach out to RnD to share your use case. Ideally, the new transcode system should be able to accommodate your use case.