---
canonical: https://amplience.com/developers/docs/user-guides/assets/video/
title: Working with video
description: User guide for working with video in Content Hub, including how to upload video and transcode files, and choosing a thumbnail as the video's poster frame.
audience: Business User
image: https://cdn.media.amplience.net/i/ampproduct/content-hub-video-upload-2?w=1200&h=630
image_width: 1200
image_height: 630
date_published: 2022-07-04
date_modified: 2026-03-31
---

# Working with video

Videos can be added to Content Hub by either uploading them individually or using bulk upload, just like any other assets. See [Uploading assets](https://amplience.com/developers/docs/user-guides/assets/upload/).

To ensure that your videos are optimized, accessible and compatible with different platforms, operating systems, and devices, you will need to transcode them.

## Transcoding videos

Transcoding video involves using [profiles](#video-transcode-profiles) to create copies of the original files with various resolutions and bitrates.

You can transcode videos either automatically during bulk uploads or manually after upload.

### Uploading video to Content Hub

When you upload a video to Content Hub manually, you have to manually apply any video transcoding profiles you want to use for encoding the video. To apply 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.

![Available transcoding profiles](https://cdn.media.amplience.net/i/ampproduct/content-hub-video-upload-2?w=1880&fmt=png 'Available transcoding profiles')

> **Note: Generating captions**
> Each video file can only have one "caption generation" profile assigned to it. If you wish to use a different captioning profile and there is already one enabled, you must remove it first.

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](https://cdn.media.amplience.net/i/ampproduct/content-hub-video-upload-3?w=1880&fmt=png 'Video is encoded using each of the profiles you selected')

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

You can access a **published** video encoded using a specified profile either by:

- Adding the profile name to the URL. For example, `https://cdn.media.amplience.net/v/ampproduct/winter-coat/mp4_720p` will return the video encoded using the mp4_720p profile

- Clicking the "Copy" button to the right of each profile to copy its URL

![Click the copy button to get the URL for the video generated using a particular profile](https://cdn.media.amplience.net/i/ampproduct/content-hub-video-upload-5?w=1880&fmt=png 'Click the copy button to get the URL for the video generated using a particular profile')

### Ingesting video using bulk upload

When video is uploaded using [FTP bulk upload](https://amplience.com/developers/docs/user-guides/assets/upload/#bulk-upload) any transcoding profiles that are set for the batch jobs will automatically be applied to the video.

If you generate captions during bulk upload, we'll check to make sure you have enough Amplience credits. If there aren't enough credits to generate captions for a video, it will be displayed in the Activity queue.

> **Note: Developer note: uploading with the GraphQL Asset Management API**
> If you use the [GraphQL Asset Management API](https://amplience.com/developers/docs/apis/asset-management/) you can [add transcoding profiles](https://amplience.com/developers/docs/apis/asset-management/overview/examples/#video-transcoding) to video assets. A transcoding profile will start processing when you add it to a video.

![When you upload a video using bulk upload, your specified profiles are applied automatically](https://cdn.media.amplience.net/i/ampproduct/video-bulk-upload-2?w=1880&fmt=png '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.

## Automatic video captions

Once you've created or edited profiles to generate captions, you can start using them for generating captions during bulk uploads and manually for files that are already uploaded.

> **Note: Video captions and Amplience credits**
> This feature requires Amplience credits for generating video captions at a rate of 5 credits per minute. See [Captions and credits](https://amplience.com/developers/docs/user-guides/assets/video/#captions-and-credit-usage).

You can you can quickly check generated captions from Content Hub by [previewing videos](https://amplience.com/developers/docs/user-guides/assets/working-with-assets/#previewing-assets).

![Previewing video captions](https://cdn.media.amplience.net/i/ampproduct/content-hub-preview-captions-example?w=1880&fmt=png 'Previewing video captions')

Generated captions are saved as Video Text Track (VTT) files that contain a transcript of the audio track along with time codes that sync the captions to the video. VTT file names are constructed by appending "-captions-_language_" to the source video's file name.

> **Tip: Identifying the language used in captions files**
> VTT file names automatically have the selected [caption language](#captions-options) appended to them, to help you identify the language used in the file. If you rename generated captions files, we recommend that you consistently use a naming convention that includes the language.

### Finding caption files

You can access a **published** video caption file by adding "-captions-_language_" to the source video's file name. For example, the video `seo-video.mp4` would have a VTT file with the name `seo-video-captions-en-GB`.

Note, that captions files use a different URL structure to videos. For example, the URL for the captions file `seo-video-captions-en-GB` on the account `ampproduct` would be `https://cdn.c1.amplience.net/c/ampproduct/seo-video-captions-en-GB`.

Each video can have only one "captions" profile applied. To apply a different captions profile, you must first remove a previously applied one.

To find captions files that have been created for specific videos use either:

- The Content Hub search feature. For example, to find captions that have been generated for the file `seo-video.mp4`, search for `seo-video-captions*`. Note, the search is case sensitive.
- The [Media Delivery API](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-overview/) to fetch the metadata for a video file using the format `https://cdn.media.amplience.net/v/<COMPANY_NAME>/<VIDEO_NAME>.json?metadata=*`. For example,
  `https://cdn.media.amplience.net/v/ampproduct/seo-video.json?metadata=*`

### Using video captions

When making videos and their captions available to your audience:

- Set the `kind` attribute to "captions". See [HTML track tag](https://www.w3schools.com/tags/tag_track.asp)
- The `srclang` attribute must be a valid [BCP 47](https://r12a.github.io/app-subtags/) language tag. Note, this attribute is optional

For example:

```html
<video
  controls
  width="100%"
  protocol="https"
  poster="https://cdn.media.amplience.net/v/ampproduct/seo-video?protocol=https"
>
  <source
    src="https://cdn.media.amplience.net/v/ampproduct/seo-video/mp4_720p?protocol=https"
  />
  <track
    label="English"
    kind="captions"
    srclang="en"
    src="https://cdn.c1.amplience.net/c/ampproduct/seo-video-captions-en-GB"
  />
  <track />
</video>
```

### Cross domain settings

If your application has strict security rules, you may wish to whitelist the captions domain: `https://cdn.c1.amplience.net` in your security policy and amend your `<video>` tag to have its [crossorigin](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/crossorigin) attribute set to `anonymous`.

### Captions and credit usage

For automatic video captions, Amplience credits are charged from when you apply a caption generation profile to a video. Previewing captioned videos doesn't require any credits.

When you manually apply a "captions enabled" profile to a video in Content Hub, we first check your Amplience credit balance to ensure you have enough credits before generating the captions.

If you run out of credits while generating captions during a bulk upload, captions will continue to be created until all credits are used up. You can check the status of caption generation for bulk uploads from the "Tools > Activity" queue.

Read more about [Amplience credits](https://amplience.com/developers/docs/ai-services/credits/).

## Video transcode profiles

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.

If you are not able to add a transcode profile, please contact your Customer Success Manager.

### Creating and editing profiles

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

![A set of video transcoding profiles will be provisioned on your account](https://cdn.media.amplience.net/i/ampproduct/video-transcode-profile-11?w=1880&fmt=png 'A set of video transcoding profiles will be provisioned on your account')

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

> **Tip: Automatically generate video captions**
> You can update existing profiles to generate video captions by setting [Captions options](#captions-options).

![Edit existing profiles by choosing Edit profile from the profile menu](https://cdn.media.amplience.net/i/ampproduct/video-transcode-profile-8?w=1880&fmt=png '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](https://cdn.media.amplience.net/i/ampproduct/video-transcode-profile-with-captions-12?w=1880&fmt=png 'The profile name, label and description')

| Name                                                     | Value                                                                                                                                                     |
| -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Friendly name                                            | Used to identify the profile within Content Hub                                                                                                           |
| Profile name                                             | HTTP friendly profile name included in the video URL                                                                                                      |
| Profile label                                            | Displayed 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 |
| Description                                              | A description of the video profile                                                                                                                        |
| Automatically attach profile to newly created batch jobs | Check this box to automatically apply a profile to a video when it is ingested into Content Hub via bulk upload. See note below.                          |

> **Note: Automatically attaching profiles to newly created batch jobs**
> The setting "Automatically attach profiles to newly created batch jobs" does not always work as expected. To ensure profiles are automatically attached to new batch jobs, please contact your Customer Support Manager or our Support team for assistance.

### Container options

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](https://cdn.media.amplience.net/i/ampproduct/video-transcode-profile-3?w=1880&fmt=png 'The available container options')

The available containers are:

**3G2**, **3GP**, **3GP2**, **3GPP**, **3GPP2**, **AAC**,

**F4A**, **F4B**, **F4V**, **FLV**, **M4A**, **MOV**, **MP3**, **MP4**,

**OGA**, **OGG**, **OGV**, **OGX**, **TS**, **WEBM**, **WMA**, **WMV**

### Audio options

You can set audio options for profiles, including the codec used to encode the video and the bit rate.

![The profile audio options](https://cdn.media.amplience.net/i/ampproduct/video-transcode-profile-5?w=1880&fmt=png 'The profile audio options')

| Name               | Value                                                                                                                                   |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| Enabled            | Check this box if the profile is to do audio transcoding                                                                                |
| Audio copy         | Copy the audio from the source video                                                                                                    |
| Codec              | The codec used to encode the audio. Select from MP3, AAC, Vorbis and WMA                                                                |
| Bit Rate           | The bit rate used to encode the audio. Generally determines the audio quality. Choose from 64, 96, 128, 160, 192, 224, 256 and 320 kbps |
| Normalise          | Increase / Decrease the volume to bring the average peak amplitude to a target normal level                                             |
| Number of channels | Either Mono or Stereo                                                                                                                   |

### Captions options

Transcoding profiles can be configured to automatically generate captions for videos. Note, to generate captions as part of bulk uploads, please contact your Customer Success Manager or Support for assistance. See [Automatically attaching profiles to newly created batch jobs](https://amplience.com/developers/docs/user-guides/assets/video/#creating-and-editing-profiles).

> **Note: Caption generation and Amplience credits**
> This feature requires Amplience credits and generates video captions at a rate of 5 credits per minute. Credits are charged when profiles are applied to videos. More about [Amplience credits](https://amplience.com/developers/docs/ai-services/credits/).

![The profile captions options](https://cdn.media.amplience.net/i/ampproduct/video-transcode-profile-captions?w=1880&fmt=png 'The profile captions options')

| Name     | Value                                                                                                                                                                           |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Enabled  | Check this box if the profile is to automatically generate captions                                                                                                             |
| Language | The language spoken in the source video. **Note**, this setting should match the one spoken in the video. Opting for a different language may result in less accurate captions. |

<details>
  <summary><b>View the list of supported languages for video auto captions</b></summary>

```json
Australian English (en-AU)
Afrikaans (af-ZA)
Brazilian Portuguese (pt-BR)
British English (en-GB)
Canadian French (fr-CA)
Danish (da-DK)
Dutch (nl-NL)
Farsi Persian (fa-IR)
French (fr-FR)
German (de-DE)
Gulf Arabic (ar-AE)
Hebrew (he-IL)
Indian English (en-IN)
Indian Hindi (hi-IN)
Indonesian (id-ID)
Irish English (en-IE)
Italian (it-IT)
Japanese (ja-JP)
Korean (ko-KR)
Malay (ms-MY)
Mandarin Chinese – Mainland (zh-CN)
Mandarin Chinese (Taiwan) (zh-TW)
Modern Standard Arabic (ar-SA)
New Zealand English (en-NZ)
Portuguese (pt-PT)
Russian (ru-RU)
Scottish English (en-AB)
South African English (en-ZA)
Spanish (es-ES)
Swiss German (de-CH)
Tamil (ta-IN)
Telugu (te-IN)
Thai (th-TH)
Turkish (tr-TR)
US English (en-US)
US Spanish (es-US)
Welsh English (en-WL)
```

</details>

### Video options

You can set video options for profiles, such as the codec used to encode the video, and the bit rate.

![The profile video options](https://cdn.media.amplience.net/i/ampproduct/video-transcode-profile-with-captions-6?w=1880&fmt=png 'The profile video options')

| Name        | Value                                                                      |
| ----------- | -------------------------------------------------------------------------- |
| Enabled     | Check this box if the profile is to do video transcoding                   |
| Video copy  | Copy the video from the source video                                       |
| Codec       | The codec used to encode the video                                         |
| Bit Rate    | The quality of the video in kbps                                           |
| Frame rate  | The number of frames per second (1-300)                                    |
| Width       | Video width                                                                |
| Height      | Video height                                                               |
| Aspect mode | Crop, Stretch, Preserve or Pad                                             |
| Upscale     | Select this option to upscale the original video to match profile settings |

### Advanced video options

There are several advanced options for the video transcoding profile.

![Advanced video options](https://cdn.media.amplience.net/i/ampproduct/video-transcode-profile-14?w=1880&fmt=png 'Advanced video options')

| Name               | Value                                                                                                            |
| ------------------ | ---------------------------------------------------------------------------------------------------------------- |
| One Pass           | Analyses and encodes the video in one pass. Can result in a larger file size.                                    |
| Speed              | Quality of video from speed of conversion ( 1 is slow, 5 is fast).                                               |
| Key Frame Interval | 0-250. Number of frames between each keyframe. This setting takes precedence over the Key Frame Rate             |
| Key Frame Rate     | 0-250. The more key frames the better navigation in the video, although more key frames increases the file size. |
| Interlace          | On, Off or Detect                                                                                                |

When you've finished entering the profile settings click the "Create" button 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.

## Setting a video thumbnail

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 context menu.

![Choosing to select a thumbnail for this video](https://cdn.media.amplience.net/i/ampproduct/content-hub-video-thumbnail-1?w=1880&fmt=png '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](https://cdn.media.amplience.net/i/ampproduct/content-hub-video-thumbnail-2?w=1880&fmt=png '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](https://cdn.media.amplience.net/i/ampproduct/content-hub-video-thumbnail-3?w=1880&fmt=png '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.

## Limitations

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

The maximum file size for manual uploads is 100MB.

## Related pages

[Supported video types](https://amplience.com/developers/docs/knowledge-center/faqs/assets/#what-video-types-are-supported)

[Working with assets](https://amplience.com/developers/docs/user-guides/assets/working-with-assets/)

[Dynamic Media API reference](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference)