Title: Clean Image Filenames Author: Upperdog Published: 3 de octubre, 2014 Last modified: 14 de enero, 2026 --- Search plugins ![](https://ps.w.org/clean-image-filenames/assets/banner-772x250.png?rev=1001368) ![](https://ps.w.org/clean-image-filenames/assets/icon-256x256.png?rev=1001365) # Clean Image Filenames By [Upperdog](https://profiles.wordpress.org/upperdog/) [Download](https://downloads.wordpress.org/plugin/clean-image-filenames.1.5.zip) * [Details](https://pe.wordpress.org/plugins/clean-image-filenames/#description) * [Reviews](https://pe.wordpress.org/plugins/clean-image-filenames/#reviews) * [Installation](https://pe.wordpress.org/plugins/clean-image-filenames/#installation) * [Development](https://pe.wordpress.org/plugins/clean-image-filenames/#developers) [Support](https://wordpress.org/support/plugin/clean-image-filenames/) ## Description This plugin automatically converts language accent characters in filenames when uploading to the media library. Characters are converted into browser and server friendly, non-accent characters. ### Características * Converts accent characters to non-accent, latin equivalents in Swedish, Danish, German, and more. * Removes special characters like exclamation marks, periods, hashtags, and more. * Lets you choose if you want to convert only image files, or all file types. * Makes site and server migrations easier thanks to non-accent character filenames. * Provides filter hook for developers who want to specify which file types to convert. ### Examples * Räksmörgås.jpg raksmorgas.jpg * Æblegrød_FTW!.gif aeblegrod-ftw.gif * Château de Ferrières.png chateau-de-ferrieres.png ### Worth noting The plugin only converts filenames when the files are being uploaded. It can not convert existing files. ### Filter for developers This filter provides developers a way to specify which file types the plugin should convert. This filter overrides the plugin settings on the media settings page. For a complete list of mime types, see [Wikipedia](http://en.wikipedia.org/wiki/Internet_media_type). The following example will convert PDF, JPEG and PNG files only: ``` function my_clean_image_filenames_mime_types() { $mime_types = array( 'application/pdf', 'image/jpeg', 'image/png', ); return $mime_types; } add_filter( 'clean_image_filenames_mime_types', 'my_clean_image_filenames_mime_types' ); ``` ## Screenshots * [[ * Easily choose between cleaning the filenames of all file types or images only. ## Installation 1. Search for Clean Image Filenames in the plugins directory. 2. Install and activate the plugin. or 1. Download and unzip the plugin and upload the `clean-image-filenames` directory to your `/plugins/` directory. 2. Activate the plugin through the ‘Plugins’ menu in WordPress. ## FAQ ### Can this plugin convert filenames of existing files in the media library? No, this plugin only cleans the filenames of files when they are being uploaded to the media library. ## Reviews ![](https://secure.gravatar.com/avatar/4dc9905fa4c51c230189fda47f0b6476ec2c4924efc2dceacff3948ac0493b69? s=60&d=retro&r=g) ### 󠀁[Works as expected](https://wordpress.org/support/topic/works-as-expected-796/)󠁿 [Kuuak](https://profiles.wordpress.org/kuuak/) 19 de diciembre, 2022 Works like indicated. Simple and efficient ![](https://secure.gravatar.com/avatar/0cb211878eae83e3a99a462153daa8b4f9b66dd383f2f8ed71e695c97f0fa5f3? s=60&d=retro&r=g) ### 󠀁[Very Good Plugin](https://wordpress.org/support/topic/very-good-plugin-2477/)󠁿 [novakpeter](https://profiles.wordpress.org/novakpeter/) 7 de junio, 2022 1 reply I recommend this. When there is diacritics in the file name, this simply substitutes that for a letter without diacritics. Works very well! ![](https://secure.gravatar.com/avatar/90b2a8f9e91729393e1e2b96d259dc882b47924b6784d679bcb97092be3326dc? s=60&d=retro&r=g) ### 󠀁[Bogus Plugin!](https://wordpress.org/support/topic/bogus-plugin-4/)󠁿 [jitbd](https://profiles.wordpress.org/jitbd/) 17 de marzo, 2022 1 reply This is completely a bogus plugin. ![](https://secure.gravatar.com/avatar/267ca5bcd9d560c6015007357761e8e72ebb097f03d2039aed9982a8fcc406cf? s=60&d=retro&r=g) ### 󠀁[Made my Day](https://wordpress.org/support/topic/made-my-day-23/)󠁿 [doomsoul](https://profiles.wordpress.org/doomsoul/) 27 de octubre, 2021 1 reply Saves my life every day, German words just have to many Äs, Ös & Üs 😉 ![](https://secure.gravatar.com/avatar/cb9358ffd8587c3498800d9c404ab24e3f8cf81596d7038125e10a65c76226de? s=60&d=retro&r=g) ### 󠀁[Perfect for Danish sites 🙂](https://wordpress.org/support/topic/perfect-for-danish-sites/)󠁿 [Bjarne Oldrup](https://profiles.wordpress.org/oldrup/) 23 de febrero, 2019 1 reply In Denmark, we use the letters æ, ø, and å, which by danish standards, are translated into ae, oe and aa when necessary. Many plugins similar to Clean Image Filenames, fails to do that properly. That’s no catastrophe, its only media filenames after all, but you might as well get it right if possible. Futhermore, titles are left alone – that’s a big plus. So the title of a file called «Æblegrød.jpg» stays that way, while the filename get converted to «aeblegroed.jpg», just as I need it. Lastly, this plugin, seems to be the only one of its kind, that has been tested with WordPress 5.1 – the others, while still working, seems abandoned. So – a big 5-star thank you from me. Bjarne ![](https://secure.gravatar.com/avatar/cb5e1d0f19055b2c444ae9ff624f270caae2f0287590ca1cfcc019c1976c26a7? s=60&d=retro&r=g) ### 󠀁[Very good plugin](https://wordpress.org/support/topic/very-good-plugin-1385/)󠁿 [miro382](https://profiles.wordpress.org/miro382/) 9 de febrero, 2019 1 reply Perfect! [ Read all 21 reviews ](https://wordpress.org/support/plugin/clean-image-filenames/reviews/) ## Contributors & Developers “Clean Image Filenames” is open source software. The following people have contributed to this plugin. Contributors * [ Upperdog ](https://profiles.wordpress.org/upperdog/) * [ Emil Gustafsson ](https://profiles.wordpress.org/gesen/) “Clean Image Filenames” has been translated into 10 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/clean-image-filenames/contributors) for their contributions. [Translate “Clean Image Filenames” into your language.](https://translate.wordpress.org/projects/wp-plugins/clean-image-filenames) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/clean-image-filenames/), check out the [SVN repository](https://plugins.svn.wordpress.org/clean-image-filenames/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/clean-image-filenames/) by [RSS](https://plugins.trac.wordpress.org/log/clean-image-filenames/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.5 * Add support for WebP and AVIF image formats. Thanks to @vinkla for the pull request. #### 1.4 * Add support for cleaning filenames when sideloaded (usually when uploaded programmatically) using the wp_handle_sideload_prefilter hook. #### 1.3 * Rewrite cleaning function to better handle specific characters. * Make sure code is compliant with WordPress Coding Standards. #### 1.2.1 * Enable plugin to be translated/internationalization. #### 1.2 * Set original, un-cleaned filename as attachment title. #### 1.1.1 * Added uninstall script that deletes plugin settings when the plugin is uninstalled. #### 1.1 * 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 * Initial release. ## Meta * Version **1.5** * Last updated **3 meses ago** * Active installations **30.000+** * WordPress version ** 2.9 or higher ** * Tested up to **6.9.4** * Languages * [Chinese (Taiwan)](https://tw.wordpress.org/plugins/clean-image-filenames/), [Czech](https://cs.wordpress.org/plugins/clean-image-filenames/), [English (US)](https://wordpress.org/plugins/clean-image-filenames/), [French (France)](https://fr.wordpress.org/plugins/clean-image-filenames/), [German](https://de.wordpress.org/plugins/clean-image-filenames/), [Latvian](https://lv.wordpress.org/plugins/clean-image-filenames/), [Spanish (Chile)](https://cl.wordpress.org/plugins/clean-image-filenames/), [Spanish (Mexico)](https://es-mx.wordpress.org/plugins/clean-image-filenames/), [Spanish (Spain)](https://es.wordpress.org/plugins/clean-image-filenames/), [Spanish (Venezuela)](https://ve.wordpress.org/plugins/clean-image-filenames/) y [Swedish](https://sv.wordpress.org/plugins/clean-image-filenames/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/clean-image-filenames) * Tags * [files](https://pe.wordpress.org/plugins/tags/files/)[images](https://pe.wordpress.org/plugins/tags/images/) [media](https://pe.wordpress.org/plugins/tags/media/)[sanitize](https://pe.wordpress.org/plugins/tags/sanitize/) [upload](https://pe.wordpress.org/plugins/tags/upload/) * [Advanced View](https://pe.wordpress.org/plugins/clean-image-filenames/advanced/) ## Ratings 4.6 out of 5 stars. * [ 18 5-star reviews ](https://wordpress.org/support/plugin/clean-image-filenames/reviews/?filter=5) * [ 1 4-star review ](https://wordpress.org/support/plugin/clean-image-filenames/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/clean-image-filenames/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/clean-image-filenames/reviews/?filter=2) * [ 2 1-star reviews ](https://wordpress.org/support/plugin/clean-image-filenames/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/clean-image-filenames/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/clean-image-filenames/reviews/) ## Contributors * [ Upperdog ](https://profiles.wordpress.org/upperdog/) * [ Emil Gustafsson ](https://profiles.wordpress.org/gesen/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/clean-image-filenames/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://paypal.me/gesen)