PHPackages                             upperdog/clean-image-filenames - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. upperdog/clean-image-filenames

ActiveWordpress-plugin[Image & Media](/categories/media)

upperdog/clean-image-filenames
==============================

A short description of what your package does

v1.5(2y ago)143295[1 issues](https://github.com/Upperdog/clean-image-filenames/issues)[2 PRs](https://github.com/Upperdog/clean-image-filenames/pulls)GPL-3.0-or-laterPHP

Since Oct 11Pushed 1y ago3 watchersCompare

[ Source](https://github.com/Upperdog/clean-image-filenames)[ Packagist](https://packagist.org/packages/upperdog/clean-image-filenames)[ Docs](https://github.com/upperdog/clean-image-filenames)[ RSS](/packages/upperdog-clean-image-filenames/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (2)Dependencies (1)Versions (5)Used By (0)

Clean Image Filenames
=====================

[](#clean-image-filenames)

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

[](#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
--------

[](#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
------------

[](#worth-noting)

The plugin only converts filenames when the files are being uploaded. It can not convert existing files.

Filter for developers
---------------------

[](#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' );

```

FAQ
---

[](#faq)

### Can this plugin convert filenames of existing files in the media library?

[](#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.

Installation
------------

[](#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.

Changelog
---------

[](#changelog)

### 1.5

[](#15)

- Add support for WebP and AVIF image formats. Thanks to @vinkla for the pull request.

### 1.4

[](#14)

- Add support for cleaning filenames when sideloaded (usually when uploaded programmatically) using the wp\_handle\_sideload\_prefilter hook.

### 1.3

[](#13)

- Rewrite cleaning function to better handle specific characters.
- Make sure code is compliant with WordPress Coding Standards.

### 1.2.1

[](#121)

- Enable plugin to be translated/internationalization.

### 1.2

[](#12)

- Set original, un-cleaned filename as attachment title.

### 1.1.1

[](#111)

- Added uninstall script that deletes plugin settings when the plugin is uninstalled.

### 1.1

[](#11)

- 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

[](#10)

- Initial release.

Upgrade Notice
--------------

[](#upgrade-notice)

### 1.1.1

[](#111-1)

This version adds plugin uninstall script that deletes plugin settings if you were to delete the plugin.

### 1.1

[](#11-1)

This version adds plugin settings to the media settings page which lets you select between cleaning the filenames of all files or images only. The filter from version 1.0 is still available.

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance33

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 99.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~666 days

Total

3

Last Release

748d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3427505?v=4)[Upperdog](/maintainers/upperdog)[@Upperdog](https://github.com/Upperdog)

---

Top Contributors

[![gesen](https://avatars.githubusercontent.com/u/2316984?v=4)](https://github.com/gesen "gesen (113 commits)")[![vinkla](https://avatars.githubusercontent.com/u/499192?v=4)](https://github.com/vinkla "vinkla (1 commits)")

---

Tags

special-characterswordpresswordpress-pluginwordpressimagesmediasanitize

### Embed Badge

![Health badge](/badges/upperdog-clean-image-filenames/health.svg)

```
[![Health](https://phpackages.com/badges/upperdog-clean-image-filenames/health.svg)](https://phpackages.com/packages/upperdog-clean-image-filenames)
```

###  Alternatives

[mindkomm/timmy

Advanced image manipulation for Timber.

17737.1k](/packages/mindkomm-timmy)[wp-sync-db/wp-sync-db-media-files

WP Sync DB Media File Addon for WP Sync DB

531151.7k](/packages/wp-sync-db-wp-sync-db-media-files)[humanmade/gaussholder

Fast and lightweight image previews for WordPress

196120.0k](/packages/humanmade-gaussholder)[wp-media/imagify-plugin

Image optimization plugin for WordPress by WP Media.

8065.3k](/packages/wp-media-imagify-plugin)[helsingborg-stad/municipio

A bootstrap theme for creating municipality sites.

4028.3k10](/packages/helsingborg-stad-municipio)[ndigitals/wp-local-media-proxy

Proxy images on a local development WordPress site from a remote server.

1347.2k](/packages/ndigitals-wp-local-media-proxy)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)