Skip to main content

Working with video

This section explains how to upload video to Content Hub and how to choose a thumbnail to use as the video's poster frame. As with other assets, video can be uploaded to Content Hub manually or via bulk upload. For manual uploads, the maximum file size is 100MB.

Uploading video to Content Hub
Link copied!

When you manually upload a video to Content Hub, you must add each of the video transcoding profiles that you want to use to encode the video. To add a profile, click the "+" icon to the left of the "Profile" label.

In the example below, the MP4-720, MP4-480 and MP4-240 profiles are available on the account and can be used to encode the winter-coat video.

The profile name, label and description

Video encoding starts when a profile is added to a video and the status bar will show the progress of the encoding process.

Video is encoded using each of the profiles you selected

When encoding has finished, the profile will be shown as completed.

Video encoding is completed

You can access a published video encoded using a specified profile by adding the profile name to the URL.

For example: will return the video encoded using the mp4_720p profile.

Click the "Copy" button to the right of each profile to copy a URL.

Click the copy button to get the URL for the video generated using a particular profile

Ingesting video using bulk upload
Link copied!

If you upload video using an FTP bulk upload, then any transcoding profiles that you have set to be applied to batch jobs will automatically be applied to the video.

developer note: uploading with the graphql asset management api

If you use the GraphQL Asset Management API to upload videos they will not be automatically transcoded, even if you have applied transcode profiles to the videos. Instead, you must transcode video files manually. See Uploading video to Content Hub.

When you upload a video using bulk upload, your specified profiles are applied automatically

You can also specify the profiles that should be attached to video ingested using a particular bulk upload job.

Setting a video thumbnail
Link copied!

You can choose a video thumbnail to be the poster frame: the frame shown before the video starts playing. 100 thumbnails are generated from a video when it is uploaded to Content Hub. These thumbnails are taken from frames at regular intervals throughout the video and you can select one to use as a poster frame. If you do not choose a thumbnail then the first frame of the video is used.

To select a thumbnail choose "Select thumbnail" from the asset's menu.

Choosing to select a thumbnail for this video

Choose the thumbnail you want to use from the thumbnails window and click the "Accept" button at the top of the window. The selected thumbnail is shown with a red border.

Click Accept to use your chosen thumbnail

The updated poster frame is now shown in Content Hub. Publish the video to make the updated poster frame available when consuming the video.

Publish the video to make the new thumbnail available

You can also upload your own thumbnail by choosing "Upload thumbnail" and uploading the image you want to use.

Video transcode profiles
Link copied!

A video transcode profile is a set of video conversion settings used to convert source videos into formats suitable for a range of devices and browsers.

Your account will be provisioned with default profiles, including MP4-240, MP4-280, MP4-720, WebM-480 and WebM-720, with settings to match most common devices and browsers, but in some circumstances you may want to create a new profile or edit an existing one.

On this page we'll show how to create and edit profiles and set parameters including video codec and bitrate and audio options.

Creating and editing profiles
Link copied!

To create a new video transcoding profile, click the New button.

A set of video transcoding profiles will be provisioned on your account

You can also edit an existing profile by clicking the icon to the left of the profile name and choosing "Edit profile".

You can edit existing profiles by choosing Edit profile from the profile menu

When you create a new profile you can enter the name, label and description, or edit these values for an existing profile.

The profile name, label and description

Friendly nameUsed to identify the profile within Content Hub
Profile nameHTTP friendly profile name included in the video URL
Profile labelDisplayed in some players to allow the user to choose the quality. Also included in the <video> tag generated when creating embedded HTML for the video
DescriptionA description of the video profile
Automatically attach profile to newly created batch jobsTick this checkbox to automatically apply a profile to a video when it is ingested into Content Hub via bulk upload

Container options
Link copied!

A profile container is the file format used to package the audio and video. Generally you will use MP4 or WebM for web content.

The available container options

The list of available containers is shown below.

  • 3G2
  • 3GP
  • 3GP2
  • 3GPP
  • 3GPP2
  • AAC
  • F4A
  • F4B
  • F4V
  • FLV
  • M4A
  • MOV
  • MP3
  • MP4
  • OGA
  • OGG
  • OGV
  • OGX
  • TS
  • WEBM
  • WMA
  • WMV

Audio options
Link copied!

In the audio section you can choose options including the codec used to encode the video and the bit rate.

The profile audio options

EnabledTick this checkbox if audio is enabled for this profile
Audio copyCopy the audio from the source video
CodecThe codec used to encode the audio. Select from MP3, AAC, Vorbis and WMA
Bit RateThe bit rate used to encode the audio. Generally determines the audio quality. Choose from 64, 96, 128, 160, 192, 224, 256 and 320 kbps
NormaliseIncrease / Decrease the volume to bring the average peak amplitude to a target normal level
Number of channelsEither Mono or Stereo

Video options
Link copied!

The video options include selecting the codec used to encode the video and the bit rate.

The profile video options

EnabledTick this checkbox if video is enabled for this profile
Video copyCopy the video from the source video
CodecThe codec used to encode the video
Bit RateThe quality of the video in kbps
Frame rateThe number of frames per second (1-300)
WidthVideo width
HeightVideo height
Aspect modeCrop, Stretch, Preserve or Pad
UpscaleSelect this option to upscale the original video to match profile settings

Advanced video options
Link copied!

You can also choose some advanced options for the video transcoding profile.

Advanced video options

One PassAnalyses and encodes the video in one pass. Can result in a larger file size.
SpeedQuality of video from speed of conversion ( 1 is slow, 5 is fast).
Key Frame Interval0-250. Number of frames between each keyframe. This setting takes precedence over the Key Frame Rate
Key Frame Rate0-250. The more key frames the better navigation in the video, although more key frames increases the file size.
InterlaceOn, Off or Detect

When you've finished entering the profile settings click the "Create" button if to create a new profile, or "Update" if you are editing an existing one. When a new profile is saved, it will be shown in the Video Transcode Profile list.

When a new profile is created it will be shown in the profile list

Link copied!

The maximum resolution at which video can be encoded is 4096 x 4096.

Supported video types

Dynamic Media API reference