SimpleMedia Module for Magnolia CMS

Version 5.x are available for Magnolia 4.5, use the 4.x releases if you need compatibility with Magnolia 4.0-4.4.x.

Warning: release 5.0.10 contains API changes due to the removal of all the deprecated Magnolia APIs. You are encouraged to upgrade to that version in order to be ready to move to Magnolia 5 (a Magnolia 5 compatible release is in the making, stay tuned):

SimpleMedia is a DAM (Digital Asset Management) module for Magnolia for the centralized management of multimedia assets like images and videos with tons of features.

The advantage of using the SimpleMedia module in your magnolia-based projects are:

  • a centralized and shared media repository
  • tracking media usage across your websites
  • tagging and searching of media
  • automatically handling resize, crop and effects on images
  • management of internal and external resouces like remote (youtube) flv videos
  • for developers, handling images/videos easily and consistently

Watch the screencasts and the screenshots to understand how simplemedia module works.



Simplemedia 4.5

New features in this release: added a "swf" mediatype and parsing of swf files metadata, improvements to the interface and a few bug fixes.

Simplemedia 4.4

 A major release with dynamic playlists and several improvements to video (hml5 player fallback, mp4 metadata handling and more).

See the full changelog for version 4.4

Simplemedia 4.3 adds pagination and improved performances

A brand new paginated interface is now available in Simplemedia 4.3. Thousands of images per folder are not a problem anymore.

Simplemedia 4.2.1 released

4.2.1 is a minor release, mainly containing bug fixes and small but useful enhancements. Among those:

  • improvements to the playlist management interface (batch selection)
  • XSPF (XML Shareable Playlist Format) support
  • more image type supported (some subset of jpeg files with particular color profiles, and ico files!)

Simplemedia release 4.2

Simplemedia 4.2 contains tons of enhancements and new features!

The major feature added in this release is playlist management (ever wanted a better way to create a photo album, a video or audio playlist on a website based on Magnolia?) but you shouldn't also miss the improvements in the UI, the handling of externally streamed video (using the rtmp/rtmpt protocol), ETK support, easier migration from "standard" image management in Magnolia.

See the full changelog for version 4.2

New in 4.2! Playlist management

It is now possible to organize media items into playlists: just enter the "Playlists" section in the Magnolia admin interface, select or create a folder in the "Playlists" tree and create a new playlist node inside it. Then populate the playlist with entries, picking media items from the media repository, and finally specify a title and description for the playlist. Reordering of the entries in a playlist can be performed via drag and drop.

The following jsp code iterates over the playlist's entries:

<cms:setNode var="playlistNode" repository="playlists" path="/samples/test" />
<cms:contentNodeIterator items="${mu:contentChildrenOfType(playlistNode, 'mgnl:playlistentry')}">
  <cms:setNode var="entryNode" />
  <media:media node="${entryNode}" property="media" />


The easy migration path

Are you still using working with images uploaded directly on page without any dedicated repository and would like to give SimpleMedia a chance?

If you are using standard magnolia "file" controls and the <cmsu:img> tags you should be able to install Simplemedia 4.2 and to see your first results in few clicks:

  • replace the "file" control in your dialogs with the "media" control
  • replace the <cmsu:img nodeDataName="x" /> tags with <media:media property="x" /> tags

As soon as you do that you should be able to open your dialog and select or upload an image to the media repository. Of course you are still not using any of the advanced feature of SimpleMedia, like resizing, cropping, and so on, but you can look at the media tags documentation for your expanded possibilities.


STK/freemarker support

Starting from version 4.1, the SimpleMedia features are available also to freemarker templates, and the usage of images stored in the media module is available by default in STK-based websites.

DAM support is automatically configured by Simplemedia if the STK module is installed. You will be able to choose Simplemedia for the storage of images (instead of direct upload or DMS) without any change to your templates. Note that in standard STK templates you will be able to select only images and not other kind of videos anyway, since templates are designed in order to only handle images.

If you use Freemarker as your favorite templating engine in Magnolia, now all the EL functions from the jsp taglibrary are also available to Freemaker templates, as static method using the "media" prefix.

For example, if in jsp you can do ${media:url(content)} you can do the following in freemarker templates: ${media.url(content)} (note the dot after "media").

You can reuse the available taglibdoc documentation for details on the media functions. Note that simplified media tags (essentially the media:media and media:player tags) are however only available in jsp templates, due to the lack of jsp 2.0 tagfiles support in freemarker. 

For developers

From the developer point of view, integrating simplemedia module is as simple as

  • add a control to your dialog in order to allow users to select media
  • use the tag media or the simplemedia el functions to render assets in your paragraphs

Check the documentation and the wiki to understand in depth simplemedia module.

Trying the SimpleMedia module

To quickly try simplemedia module, download the magnolia bundled webapp from and explode it on your disk.

Then download simplemedia module bundle from and extract jar files to the WEB-INF/lib of previously extracted magnolia bundled webapp.

Start your application server and start enjoying simplemedia module!

Look at the screencasts to start learning simplemedia module usage.

Simplemedia 4.5

New feature in this release: added a "swf" mediatype and parsing of swf files metadata, improvements to the interface and a few bug fixes.

Project info & quick links