Clean Image Filenames

Wordpress Plugin
Download latest - 1.3



Download Stats

Today 58
Yesterday 94
Last Week 495
All Time 36,037
Banner 772x250

Filenames with special characters or language accent characters, like Chteau de Ferrires.jpg and smrgsbord.png, can sometimes be a problem for browsers or servers. This plugin takes care of that and cleans the filenames of files uploaded to the WordPress media library.

This plugin cleans the filenames from special characters like exclamation marks, periods, and commas and accent characters like Swedish and German umlauts. Special characters are remove, accent characters are converted to their non-accent equivalent, and blank spaces are converted into dashes.

Easily set the plugin to clean the filenames of images only or all files uploaded to the media library. Developers can take advantage of the built in filter to get really specific about what file types to clean the filenames of.


  • Can be used for all file types, not only images
  • Multisite compatible
  • Works with custom upload_dir setups
  • Doesn't alter your database or uploads settings
  • Gutenberg ready

Plugin filter for developers

Developers can get really specific about what file types to clean by using the clean_image_filenames_mime_types filter in their plugins or themes. When using this filter, settings saved through the settings page are overridden. For a complete list of mime types, see Wikipedia.

The following example would make the plugin clean the filenames for PDF, JPEG and PNG files only.

function my_clean_image_filenames_mime_types() {
    $mime_types = array(
    return $mime_types;
add_filter('clean_image_filenames_mime_types', 'my_clean_image_filenames_mime_types');

Releases (5 )

Version Release Date Change Log
1.2.1 2018-03-02
  • Enable plugin to be translated/internationalization.
1.2 2018-02-19
  • Set original, un-cleaned filename as attachment title.
1.1.1 2017-10-31
  • Added uninstall script that deletes plugin settings when the plugin is uninstalled.
1.1 2014-12-14
  • Added plugin settings to media settings page with option to convert all file types or just image file types.
  • Added shortcut to plugin settings from the plugins list.
1.0 2014-11-27
  • Initial release.