Extending media processing flows

In Sitecore Content Hub you can extend the media processing flows to create new asset renditions. The best practices provided here can help you configure the creation of renditions according to your business needs.


We recommend that you turn on the Store output switch in the Extract metadata section of the parameters panel for the metadata rendition. Changing the default settings or turning off the Store output switch can have unexpected results.

Extending media processing flows

As a general rule, apply the following best practices when extending media processing flows:

  • Limit the number of renditions to avoid generating too many, because uploading an asset triggers the creation of all its renditions. Whenever possible, use the existing renditions (Medium/Preview, Thumbnail, Big Thumbnail). Provide the fewest renditions that fit the most use cases possible for users to download and use locally, because the more renditions you have, the more storage will be used. Please note that TIFF renditions require a lot of storage space.

  • If the rendition you want to create is smaller than 1100x1100, create a new flow based on the Preview flow. If it's larger than 1100x1100, create a new flow from the original one. We recommend you use 2000x2000 for Images: PDF Rendition.

  • Wherever possible, make use of public links with transformations.

  • If smart cropping or crop-to-center transformations don’t produce results you like in some situations, you can manually create public links instead.

  • After you upload an asset, Content Hub generates a PDF version whenever you deep zoom or annotate the asset.

  • When selecting a Color Profile, we recommend that you use RGB for on-screen viewing and CMYK for printed media. If the output isn't correct, try different color profiles or color space combinations within the processing task's parameters.

  • Select Store output if you want to use the task output, for example downloading and displaying assets through a rendition link. Specify an output name before clicking the Rendition link button, and make sure to set up the Intended area of use.

  • Ensure you configure your Media Processing flows before migrating to another Content Hub instance.

Creating new renditions

You can make your rendition available for cloud integration or for local download.

Renditions for cloud integration

For cloud integration, make sure to create the fewest possible high-resolution renditions that fit most file types. Generate special formats for EPS, AI, or PSD raw files.

Renditions for download

You can create renditions to be either downloaded by users or shown inline in the browser (for example, to show a preview of an asset on a page). When a rendition is properly configured for download, it can be selected on operations such as Download and will be shown on components such as Renditions.

To configure a rendition for download:

  1. On the menu bar, click Manage cog icon.

  2. On the Manage page, click Media processing.

  3. On the Media processing page, in the left-hand pane, click a processing set, then click the flow you want to add a task to.

  4. On the visual canvas, on the node of the flow you want to add the task to, click plus sign.

  5. In the right-hand pane, select Convert image.

  6. In the Convert image pane, under Content disposition, select Attachment.

  7. On the Outputs tab, turn on the Store output switch. Under Rendition link, click New link.

  8. In the New link dialog, select Download under Intent and under Intended area of use.


For the full procedure for adding flow tasks, see adding media processing tasks. For use case examples, see Media processing use cases.

If you have a public link for an asset rendition, and then you set up a new file as master, consider the following:

  • If the new master file rendition is the same as the previous master file rendition, then the public link remains valid for this new master file.

  • If the new and old master file renditions are different (for example, Original and Preview), the public link becomes invalid. If you want a public link for the new master file, you need to create one.

  • If you apply a crop to a public link, and later replace that link's master file with one that has different dimensions, the cropping configuration will be reset. In such cases, a notification will inform you of the reset.

Do you have some feedback for us?

If you have suggestions for improving this article,