Smarter ideas worth writing about.

Working with CQ5 Video Profiles


In a previous post, I discussed why video content can be an important part of a site and why having a Digital Asset Management system like CQ5 DAM is helpful in creating the various renditions needed to deliver this content to your users. In this post, I will explain more about how to use CQ5 Video Profiles.


Video Profiles

A CQ5 Video Profile is a set of video configuration properties for a particular type of video format.  These configuration settings are used by the transcoding workflow when generating alternate formats of an uploaded video asset.  The configuration settings are fed into FFmpeg, which is the video transcoder used by CQ5 DAM. FFmpeg is not installed as part of the quickstart jar, and needs to be in place before attempting to transcode videos. To do that, follow the instructions here.  The Video Profiles are also used by the video player component when determining the appropriate format to play back to an end user when viewing video content on a page.


Creating a Video Profile

Before you can transcode a video that you have uploaded to the DAM, you have to have one or more Video Profile pages created. The out of the box implementation has a profile for H.264, Ogg Vorbis and Flash Video files. You can also create new pages with new configurations as you see fit.

Below are the steps for creating or editing Video Profile Pages.

  • Navigate to the tools page.

  • Find the DAM folder and expand it to find the Video Profiles folder.  This folder contains a collection of Video Profile pages. To edit one, just open the page. To create a new one, just create a new page.  
  • The edit dialog gives you some of the more common options for configuration.  It also includes an advanced tab where you may specify additional flags to pass to FFmpeg.  After you have configured the settings to your liking, you have the option of uploading a sample video file to test the conversion and ensure it works.

Configuring the DAM Update Asset Workflow

After creating the Video Profiles, the next step is to ensure that they are added to the workflow step that is triggered when a new video is added to the DAM. Again, by default, the workflow step already has entries for the pre-configured Video Profiles. If you create a new one and wish to use it, you’ll need to update this step.

  • Navigate to the tools page.
  • Find the Workflow/Models/dam/update_asset page.
  • Open that page for editing and examine the arguments specified in the Process tab of the dialog.  The value is a comma delimited list of profile names, such as profile:hq, profile:firefohq, etc.  If you have created a new video Profile page with a name of 'fantastic264', you would just add 'profile:fantastic264' to the list of values.
  • Each profile you have listed will used with FFmpeg to create a rendition of your video.



Video Player Component

The out of the box CQ5 video component utilizes an HTML5 Video with Flash player fallback implementation.  The way you configure this is to open the design dialog for the component and specify the Video Profiles that you would like to use.

The list of Video Profiles available is populated dynamically based on the Video Profile pages that have been created.


The component is able to identify the path of the video resource based on the Video Profile(s) selected. As you can see, more than one source can be added, which is part of an HTML5 Video with Flash Player fallback strategy.


Video Profiles are a convenient way to configure CQ5 to create renditions of videos added to CQ5 DAM using FFmpeg.  I hope the information here will give you a better understanding of how Video Profiles are used by CQ5 and how to create and tweak your own.

Happy transcoding!


About The Author

Technical Architect, Adobe Enterprise Solutions
Ryan is a solution architect specializing in Adobe enterprise technologies including CQ5, LiveCycle and Flex and is a Team Lead in the Adobe Enterprise Solutions Practice.