Documentation AEM as a Cloud Service User Guide

New Video Viewer in Dynamic Media new-video-viewer-dynamic-media

Last update: Tue Mar 17 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Applies to:
Experience Manager as a Cloud Service

CREATED FOR:

User

The New Video Viewer for Dynamic Media provides a modernized video playback experience in Adobe Experience Manager (AEM). It delivers a consistent and extensible viewing experience across authoring, preview, and Sites environments, while continuing to work with existing Dynamic Media workflows.

Existing video viewers in Dynamic Media support core playback requirements but provide limited extensibility and event-level integration for modern analytics and integration scenarios

The New Video Viewer addresses these limitations by:

Providing a more consistent playback experience
Allowing explicit viewer selection
Emitting structured playback events for programmatic consumption
Supporting integration with external analytics and external systems

The viewer is available as an additional option and requires explicit selection where supported. It does not automatically replace existing video viewers.

The New Video Viewer is intended for organizations that require an enhanced and extensible video experience without disrupting existing implementations.

NOTE

The New Video Viewer is a limited availability feature. You can get it enabled by creating a support ticket.

How the New Video Viewer works how-it-works

The New Video Viewer works as follows:

A video asset is ingested into a folder that is synced with Dynamic Media.
The video can be previewed from the asset details page using Video (new).
The New Video Viewer can be selected in the Dynamic Media component when authoring Sites pages.
During playback, the viewer emits structured events to the parent window.
Optional viewer modifiers can be used to control playback behavior.

Key differences from the existing Video Viewer key-differences

Area

Description

Viewer availability

Appears as a new option named Video (new)

Viewer selection

Must be explicitly selected

Extensibility

Emits structured playback events

Integration

Continues to work with existing Dynamic Media workflows

Prerequisites prerequisites

Before using the New Video Viewer, ensure the following prerequisites are met:

Requirement

Description

Dynamic Media sync

The asset folder must be synced with Dynamic Media.

Video profile

A video profile must be applied to the folder.

Video asset

A video must be ingested into the folder.

The New Video Viewer is available starting with AEM as a Cloud Service version 2025.7.0.

To enable or disable the New Video Viewer, contact Adobe Customer Care.

Preview the New Video Viewer preview

Execute the following steps to preview the New Video Viewer from the asset details page:

Navigate to Assets > Files, and open the folder containing the video asset.
Click the video asset to open the asset details page.
In the left panel, click Viewers.
In the Viewers panel, select Video (new).
Click URL to copy the preview link.

Use the New Video Viewer in Sites use-in-sites

The New Video Viewer is available through the existing Dynamic Media component in AEM Sites.

Add the Dynamic Media component

Execute the following steps to add a video using the Dynamic Media component:

Open the page in the Sites editor.
Drag the Dynamic Media component to the required location on the page.
Select the Dynamic Media component on the page.
Click the component to open the asset selector.
Select a video asset.

Drag Dynamic Media component

Configure the viewer

Execute the following steps to configure the viewer preset:

Select the Dynamic Media component on the page.
Click Configure in the component toolbar.
In the Dynamic Media settings dialog, select Video (new) from the Viewer Preset drop-down list.
Enter any required modifiers in the Viewer Modifiers field (for example, autoplay=true&muted=true).
Save the changes.

The video loads on the page using the New Video Viewer.

Note: The New Video Viewer does not automatically replace existing videos. Users must manually select Video (new) in the Viewer Preset when using the Dynamic Media component, or update direct URLs to point to the New Video Viewer where needed.

Migrating videos using direct URLs

If your videos are accessed via direct URLs instead of the Dynamic Media component, you can switch them to the New Video Viewer by updating the URL. For example: https://s7d1.scene7.com/dmviewers/html5/VideoViewer.html?asset=<video-asset>

Viewer modifiers viewer-modifiers

Viewer modifiers allow you to control asset loading, playback behavior, streaming format selection, and viewer presentation.

Modifier

Description

asset

Specifies the asset ID of the video or Adaptive Video Set.

posterimage

Specifies the image displayed before playback starts.

serverurl

Specifies the Image Serving root path.

contenturl

Specifies the content root path.

videoserverurl

Specifies the video server root path.

sources.dash

Specifies the DASH manifest URL for playback.

sources.hls

Specifies the HLS manifest URL for playback.

autoplay=true

Starts playback automatically when the video loads.

controls=true/false

Shows or hides the video playback controls.

loop=true

Restarts playback automatically after the video ends.

muted=true

Starts playback in a muted state.

playbackrates

Specifies the available playback speed options.

playback

Specifies the streaming format (auto, hls, dash, or progressive).

progressivebitrate

Specifies the bitrate for progressive playback.

initialbitrate

Specifies the initial bitrate for adaptive streaming.

isletterboxed=true/false

Controls whether the video is letterboxed or stretched.

customcss

Specifies a custom CSS file for viewer styling.

transition

Specifies the show or hide transition behavior for viewer controls.

Modifiers are specified as query parameters in the Viewer Modifiers field.

Supported events supported-events

The New Video Viewer emits the following events during playback:

Event type

Description

play

Video starts playing

pause

Video is paused

seek

User seeks within the video

load

Video is loaded

Player is closed

metadata

Metadata such as duration

milestone

Playback milestone reached

current_time

Periodic playback position

fullscreen

Enter fullscreen

un_fullscreen

Exit fullscreen

Handling events in the parent window handling-events

The New Video Viewer sends playback-related messages to the parent page during video interactions.

To handle these events, the parent application must listen for browser message events and validate the message origin before processing the data.

The event payload includes information such as the event type, playback state, current playback time, and additional metadata. These events can be used to support analytics tracking, custom interactions, or integration with external systems.

Adobe recommends validating the message origin to ensure that events are processed only from trusted Dynamic Media domains.

Video Engagement Report for the New Video Viewer video-engagement-report

The Video Engagement Report provides analytics metrics for videos played using the New Video Viewer in Dynamic Media. The report delivers aggregated performance data for the specified month and supports monthly reporting.

Reports are generated upon request. To request a report, create a support ticket and provide the following details:

Month of report – Specify the month for which the report is required (for example, January 2026).
Delivery email address – Email address of the group (recommended) or individual to deliver the report

The report provides per-video engagement metrics, including views, impressions, watch time, completion rate, and engagement score.

Report format

Reports are delivered in CSV format.
Each row represents a single video.
Metrics are aggregated for the selected reporting period.
Deleted assets are excluded from the report.
Supports filtering by tenant_name.

Report fields

The Video Engagement Report includes the following fields:

Field

Description

Calculation

video_id

Unique video identifier.

video_name

Name of the video asset.

video_created_date

Date the video was created.

duration_in_seconds

Duration of the video in seconds.

video_views

Total number of video play events during the selected reporting period.

video_impressions

Total number of times the video was loaded.

video_watched_seconds

Total seconds watched across all play events.

Sum of seconds watched across all play events

play_rate

Percentage of video plays relative to video loads.

(video_views ÷ video_impressions) × 100

avg_time_watched_in_seconds

Average seconds watched per view.

video_watched_seconds ÷ video_views

avg_completion_rate

Percentage of views that reached full video completion.

(Completed views ÷ video_views) × 100

engagement_score

Average watch percentage across all play events.

(Total percentage of video timeline viewed across all sessions ÷ video_views)

tenant_name

Identifier of the company or tenant associated with the data.

Frequently asked questions faq-video-engagement

If a video is set to autoplay, is it counted as a view automatically, or only after the user watches for a minimum duration?

Autoplay is counted as a video view. Playback initiated automatically is recorded as a view.

If a user watches only part of a video (for example, the first 2 seconds and the last 2 seconds of a 10-second video), is it counted as a completed view?

A view is counted as completed when playback reaches the end of the video timeline, even if portions of the video were skipped.

If a user scrubs backward and re-watches portions of the video, does it increase the video_views count, the engagement_score, or both?

Re-watching portions of the video does not increase the video_views count. Additional playback contributes to the engagement_score.

If the same user watches the same video multiple times without reloading the page, how are video_views and engagement_score calculated?

Repeated playback without reloading the page does not increase the video_views count. Additional playback contributes to the engagement_score.

Does pausing and resuming a video affect engagement tracking or completion rate calculation?

Pausing and resuming playback does not affect engagement tracking or completion rate calculation.

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab