Last updated 29 October 2015. Created on 10 January 2009.
Edited by ashish_nirmohi, pbulebar, Devin Carlson, andyhu. Log in to edit this page.

Media attempts to resolve the long-standing problem of handling media using Drupal.

Media provides a common framework to unify multimedia and file development efforts. Developers can focus on their expertise or interests, without having to worry about file handling or the integration of their work with other developer's modules.

For a collection of useful materials for anyone working with media modules in Drupal, see Resource Guide: Managing Media in Drupal.

File and Media Handling

With Media, it is possible to handle both local files (images, video, sound files, etc), remote files (over http://, https://, or feed://) and remote media (YouTube, Vimeo) in the same manner. Remote files and media do not have to be saved to the local server and can be streamed remotely.

*Note that Media simply handles files. Adding new files and other file-related functionality, such as adding fields to files, is handled by the File Entity module.

Browsing Multimedia

Media provides a multimedia browser which allows a user to view and search through all of the multimedia currently added to a site. The browser also enables users to add existing multimedia to file fields or text areas using a WYSIWYG editor.

Displaying Multimedia

Media facilitates the display and playback of multimedia through the creation of media players. Media players may be designed for one or more types of multimedia, such as .pdf documents, .mp3 music or .mp4 video. Media players can be assigned to any number of file types

*Note that Media does not include any media players. You must download an appropriate media player for the file type you need to display. A list of available media players can be found on the Modules that Extend the Media Module page.

If you find a mistake or an omission in the documentation, please create an issue in the media issue queue (when filing an issue, select the "Documentation" component).

Looking for support? Visit the forums, or join #drupal-support in IRC.


JoshuaKissoon’s picture

Tutorial video with example usage can be found at:

druvision’s picture

Here is a tutorial on how to create youtube videos fields

Alauddin’s picture

By default media module links media to /media/[fid] as a result of this being a entity field
In order to link the media field back to its content page you need this module

See instructions here.

internetman22’s picture

The bloat in the Drupal community is unmaintainable. This module is a disaster. Can you explain WHY this module NEEDS to hide file extensions? MP3s don't get proper mime-types because this awesome module decides it needs to rename the file and save it in the database. Why does it rename "very descriptive filename.mp3" to "mp3_0". Really? What does this help exactly?

bkelly’s picture

A nightmare doesn't even begin to describe this.

I've inherited a system using this and it has issues. If you ever try to pry this thing out of your system your in for a real treat. You have to write a script/update hook to process every page and convert [[{"type":"media","view_mode":"media_original","fid":"21","attributes":{"alt":"","class":"media-image","height":"172","typeof":"foaf:Image","width":"240"}}]] to /sites/default/files/descripitive_imagename.jpg.

Not a trivial task!