Plugin info

Total downloads: 323,819
Active installs: 30,000
Total reviews: 21
Average rating: 4.6
Support threads opened: 0
Support threads resolved: 0 (0%)
Available in: 12 language(s)
Contributors: 2
Last updated: 4/22/2025 (253 days ago)
Added to WordPress: 10/3/2014 (11 years old)
Minimum WordPress version: 2.9
Tested up to WordPress version: 6.8.3
Minimum PHP version: f

Maintenance & Compatibility

Maintenance score

Stale • Last updated 253 days ago • 21 reviews

42/100

Is Clean Image Filenames abandoned?

Likely maintained (last update 253 days ago).

Compatibility

Requires WordPress: 2.9
Tested up to: 6.8.3
Requires PHP: f

Similar & Alternatives

Explore plugins with similar tags, and compare key metrics like downloads, ratings, updates, support, and WP/PHP compatibility.

Healthy filename
Rating 0.0/5 (0 reviews)Active installs 200
WP Sanitize Accented Uploads
Rating 5.0/5 (2 reviews)Active installs 900
Safe SVG
Rating 4.9/5 (76 reviews)Active installs 1,000,000
Filenames to latin
Rating 4.9/5 (14 reviews)Active installs 10,000
Clean Filenames
Rating 4.6/5 (8 reviews)Active installs 3,000
BEA – Sanitize Filename
Rating 5.0/5 (4 reviews)Active installs 1,000

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.

Features

  • 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.

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' );

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.

Frequently Asked Questions

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.

Review feed

felixprojekt
12/1/2018

Does what it says

Using it happily on many websites without any issue.
Kuuak
12/19/2022

Works as expected

Works like indicated. Simple and efficient

Screenshots

  1. Easily choose between cleaning the filenames of all file types or images only.

    Easily choose between cleaning the filenames of all file types or images only.

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.