Documentation Center

Custom Media Manager players

Starting from version 1.5, SDL Digital Experience Accelerator (DXA) provides support for custom Media Manager players.

DXA 1.5 provides you with two example custom players: carousel.js for Image Distribution, and html5player.js for Video. You can find both examples on the DXA GitHub website.

The carousel-mm.js example allows you to display the Media Manager Image Distribution in form of a carousel.

The html5player.js example allows you to customize your video player and it comes with the following set of parameters that you can enable:
  • cusomVideoAutoplay - allows a video to play automatically once a page where it is located opens.
  • customVideoSubtitles - turns on/off the video subtitles.
  • customVideoControls - turns on/off the video controls.

To see a list of custom parameters for Media Manager players, go to BuildingBlocks/Modules/MediaManager/Editor/Schemas/SDL Media Manager. In the Schema Fields section, you can find the list of all new custom parameters.

You can enable these custom parameters for each individual Media Manager Item you create using Content Manager Explorrer (CME) or Experience Manager (XPM). See an example of metadata for a custom video player below:

To enable a custom parameters for a player, make sure that its playerType parameter is set to Custom. By default, all newly created media Items have their playerType parameters set to Custom. If playerType is set to Standard, you cannot customize any of the players and their custom parameters are ignored.

You can also customize the custom players, see .