About
This article explains how Webmasters embed videos on AEM pages using the Kaltura Video component.
Videos are uploaded and prepared in Kaltura by a media or marketing role. Webmasters select approved videos and embed them on pages.
Note about permissions: Webmasters can browse and embed approved media they have access to in Kaltura. Uploading and managing video files is handled by a separate media or marketing role. If required media is not available, contact your Kaltura administrator.
Add the Kaltura Video component to a page
- Open a page in AEM’s page editor.
- Open the Components panel on the left, and drag the Kaltura Video component onto the page.
- Select the Kaltura video component on the page, and then click the wrench icon.
If the Kaltura Video component does not appear, it may not be enabled in the page template. See Setup guide for Kaltura Connector for AEM (Adobe Experience Manager) for guidance.
Select videos
In the window, you can search existing media across different repositories:
- My Media - Your personal uploaded videos.
- Media Gallery - Shared videos you have access to
- Shared Repository - Company-wide shared videos (if enabled by your administrator).
You can also upload or record new videos. See Add new videos below.
- Your embed window may look different depending on how many columns your admin has configured.
- You can embed audio files using Kaltura’s audio player. The player is available in the list of player options in the customize embed settings (see below).
- Mandatory captions before embedding - If your admin has enabled the 'Captions Required' setting, certain media types (like video, audio, or quizzes) must have captions in order to be embedded. Items without captions will have grayed-out buttons.
You can use the search bar and filters to locate content.
To preview more details, click the eye icon next to a media item. The sidebar opens with a playable preview (if available) and media details.
Add new videos
To upload or record new media, use one of the following options:
- Upload - Upload one or more files. Wait for uploads to finish before clicking Save and Select. Visit our article Upload media for guidance.
- Express Capture - Record directly from your webcam. Visit our article Create a recording with Express Capture for guidance.
Once the upload is complete, click the settings icon to adjust embed options (see Customize embed settings).
If your administrator has required metadata fields (such as tags or descriptions), you must complete them before embedding.
Customize embed settings
1. Click the customize icon next to the media you want to embed.
The Customize Embed option may not be available in all environments. This feature must be enabled by your administrator in the Browseandembed module.
The 'Customize embed' window opens.
2. You can configure the following settings:
Select a player - Choose from pre-configured players set by your administrator.
When you change the selected player, the preview updates automatically to reflect your choice.
Select video display size - Set the maximum display size of the embedded media. Your administrator defines the available embed sizes.
Thumbnail embed - Toggle on to display a static preview image instead of loading the full video player immediately. This helps improve page load speed and gives users control over when to play the video.
Enabling or disabling this option will also update the preview in real time.
You can share the video from a specific time. Choose Start video at and enter the time according to the format given (00.00). For example, if you want a video to start at 1 minute and 30 seconds into the video, enter 01.30
Save these settings as defaults for videos - Enable this option to apply the same settings automatically to future embeds of this media type.
When you change a setting, the preview updates automatically.
3. Once you’re ready, click Embed.
The content is embedded.
You can add multiple Kaltura Video components to the same page and embed different videos in each component.
Watch a quick tutorial: Upload and embed a Kaltura video:
Replace an embedded video
You can replace a video without removing the Kaltura Video component from the page.
- Select the existing Kaltura Video component on the page.
- Click the wrench icon.
- In the Kaltura video component window, select a different media item.
- Click Embed.
The newly selected video replaces the previous one, and the page layout remains unchanged.
Accessibility notes
Accessibility features such as captions, subtitles, audio descriptions, and keyboard navigation are controlled by the selected player and the media configuration in Kaltura.
Availability depends on:
- Whether captions or audio descriptions exist for the media
- How the selected player is configured by your administrator
If required accessibility options are missing, contact your administrator.
