8.5.x file.api.php hook_file_mimetype_mapping_alter(&$mapping)
8.0.x file.api.php hook_file_mimetype_mapping_alter(&$mapping)
8.1.x file.api.php hook_file_mimetype_mapping_alter(&$mapping)
8.2.x file.api.php hook_file_mimetype_mapping_alter(&$mapping)
8.3.x file.api.php hook_file_mimetype_mapping_alter(&$mapping)
8.4.x file.api.php hook_file_mimetype_mapping_alter(&$mapping)
8.6.x file.api.php hook_file_mimetype_mapping_alter(&$mapping)
7.x system.api.php hook_file_mimetype_mapping_alter(&$mapping)

Alter MIME type mappings used to determine MIME type from a file extension.

This hook is run when file_mimetype_mapping() is called. It is used to allow modules to add to or modify the default mapping from file_default_mimetype_mapping().


$mapping: An array of mimetypes correlated to the extensions that relate to them. The array has 'mimetypes' and 'extensions' elements, each of which is an array.

See also


Related topics

1 function implements hook_file_mimetype_mapping_alter()

Note: this list is generated by pattern matching, so it may include some functions that are not actually implementations of this hook.

file_test_file_mimetype_mapping_alter in modules/simpletest/tests/file_test.module
Implements hook_file_mimetype_mapping_alter().
1 invocation of hook_file_mimetype_mapping_alter()
file_mimetype_mapping in includes/file.mimetypes.inc
Return an array of MIME extension mappings.


modules/system/system.api.php, line 3964
Hooks provided by Drupal core and the System module.


function hook_file_mimetype_mapping_alter(&$mapping) {

  // Add new MIME type 'drupal/info'.
  $mapping['mimetypes']['example_info'] = 'drupal/info';

  // Add new extension '.info' and map it to the 'drupal/info' MIME type.
  $mapping['extensions']['info'] = 'example_info';

  // Override existing extension mapping for '.ogg' files.
  $mapping['extensions']['ogg'] = 189;


Dave Reid’s picture

Be vary careful when adding new entries. Since these mappings are numeric, you must ensure that you are not accidentally overwriting new entries. Here is the code we are using in the Media/File entity modules to add support for new mappings that will work with existing entries and not cause any regressions or data overwriting:

 * Implements hook_file_mimetype_mapping_alter().
function mymodule_file_mimetype_mapping_alter(&$mapping) {
  // Fix the mime type mapping for ogg.
  $new_mappings['ogg'] = 'audio/ogg';

  // Add support for m4v.
  $new_mappings['m4v'] = 'video/x-m4v';

  // Add support for mka and mkv.
  $new_mappings['mka'] = 'audio/x-matroska';
  $new_mappings['mkv'] = 'video/x-matroska';

  foreach ($new_mappings as $extension => $mime_type) {
    if (!in_array($mime_type, $mapping['mimetypes'])) {
      // If the mime type does not already exist, add it.
      $mapping['mimetypes'][] = $mime_type;

    // Get the index of the mime type and assign the extension to that key.
    $index = array_search($mime_type, $mapping['mimetypes']);
    $mapping['extensions'][$extension] = $index;