Media File Renamer – Auto & Manual Rename


Renames your media files for better SEO and a nicer filesystem (automatically or manually). For more information, please visit the official website: Media File Renamer.


Media File Renamer, by default, automatically renames the filenames of your Media entries based on their titles. You can trigger this, or you can let it happen every time you modify titles. You can also rename the files manually. The references to those files will be also updated (posts, pages, custom types, metadata, etc…). You can use the Media Library, or the Media Edit screen.

However, it is highly recommended to use the pretty and very dynamic Renamer Dashboard. If you like to work fast and well, you will really love working with this modern dashboard.

Please have a look at the tutorial.


It works with a lot of features of WordPress and other plugins, such as Retina files, WebP, rescaled image (since WP 5.3), PDF Thumbnails, UTF8 files, optimized images, various encodings, etc. There are too many handled and specific cases to be listed here, but we are doing our best to keep up with everything 🙂


More features are added in the Pro Version, such as:
– Transliteration (replace various accents, emoticons, umlauts, cyrillic, diacritics, by their ASCII equivalent)
– Automatic renaming based on the attached posts, products (and other post types), or ALT text
– Anonymizer (rename the files with anonymous files)
– Move files to another directory
– Metadata syncing (ALT text, title, etc)
– Numbered files (to allow similar filenames to be renamed)
– Force Rename (if your install is broken, this will help you to re-link your media entries to your files)


Renaming (or moving) files is a dangerous process. Before doing anything in bulk, try renaming your files on by one, then check if the references (in your pages) have been updated properly. The renaming can’t cover all use cases, as some plugins are unfortunately using unconventional ways to encode the usage of the files. Therefore, it is absolutely necessary to backup your files and database in order to enjoy this plugin at its full extent.


If your website seems broken after a few renames, try to clear your cache. The cached HTML is often using the old references. You can also enable the Undo feature and try to rollback to the previous filenames. If references aren’t updated properly, please write a nice post (not an angry one) in the support threads 🙂 I am trying my best to cover more and more use cases. Please have a look here: Questions & Issues.


If you only need an editable field in order to modify the filename, please try Phoenix Media Rename. It’s simpler, and just does that. And yes, we are friends and we collaborate! 🙂


The plugin can be tweaked in many ways, there are many actions and filters available. Through them, for example, you can customize the automatic renaming to your liking. There is also a little API that you can call. More about this here.


  • Type in the name of your media, that is all.
  • Special screen for bulk actions.
  • This needs to be renamed.
  • The little lock and unlock icons.
  • Options for the automatic renaming (there are more options than just this).


  1. Upload the plugin to your WordPress.
  2. Activate the plugin through the ‚Plugins‘ menu.
  3. Try it with one file first! 🙂


1. Februar 2021
This is one of the plugins you need if you are obsessed with organization. I was unsure which pictures I am using and which are copies, so this really helped streamline the process of keeping things consistent. Thank you for making such a great plugin!
8. Dezember 2020
I have used so many images with no SEO value. Thanks
1. Dezember 2020
Jordy was very quick, friendly and responsive when i had a request for the plugin. If you are managing a lot of media, this is a absolutely must-have plugin for SEO. Thanks for a great work and great support🙂
Lies alle 323 Rezensionen

Mitwirkende & Entwickler

„Media File Renamer – Auto & Manual Rename“ ist Open-Source-Software. Folgende Menschen haben an diesem Plugin mitgewirkt:


„Media File Renamer – Auto & Manual Rename“ wurde in 10 Sprachen übersetzt. Danke an die Übersetzerinnen und Übersetzer für ihre Mitwirkung.

Übersetze „Media File Renamer – Auto & Manual Rename“ in deine Sprache.

Interessiert an der Entwicklung?

Durchstöbere den Code, sieh dir das SVN Repository an oder abonniere das Entwicklungsprotokoll per RSS.


5.1.6 (2021/02/12)

  • Fix: References for moved files were not updated.
  • Add: Sanitize filename after they have been through the mfrh_new_filename filter.


  • Add: Greek support.
  • Fix: Better sensitive file check.
  • Fix: Manual rename with WP CLI.


  • Add: Auto attach feature.
  • Add: Added Locked in the filters.
  • Update: Icons position.


  • Fix: Issue with roles overriding and WP-CLI.
  • Fix: Issue with REST in the Common Dashboard.


  • Add: Support overriding roles.
  • Fix: The layout of the dashboard was broken by WPBakery.


  • Fix: Rules for renaming files with slashes were imperfect.
  • Fix: ArgumentCountError with action_sync_alt (too few arguments).
  • Update: Avoid useless async refreshes.

5.0.8 (2020/09/26)

  • Fix: Two options were not working very logically.
  • Fix: Avoid errors when the PHP Error Logs is too big.
  • Update: Use Nonce for Rest API.

5.0.7 (2020/09/08)

  • Fix: Incompatibility with WordPress 4.8.

5.0.6 (2020/09/08)

  • Update: A check for the rename status was performed for every entry in the Media Library all at the same time, and that was causing slower performance (especially when more than 10 or 20 entries are displayed per page). It’s now performed with a maximum of two concurrent requests at a time.
  • Note: If you like it, please review the plugin by clicking here. It’s important for us 🙂 Thank you!

5.0.5 (2020/09/04)

  • Fix: Issue with case sensitive filenames fixed.
  • Update: Additional rules for auto-renaming.

5.0.4 (2020/08/29)

  • Fix: Undo All wasn’t working on WordPress install with modified DB prefixes.
  • Fix: Works with Plain Permalinks.
  • Update: More natural feel for the field in the Media Library.

5.0.3 (2020/08/21)

  • Fix: Use MutationObserver to make sure the Renamer Field attach itself to dynamic Media Librairies.
  • Fix: Fixed a notice related to WP 5.5.
  • Update: Better handling of emoticons.


  • Info: Brand new UI! Made everything much clearer.
  • Fix: Method was not always taken in account.


  • Info: Brand new UI! Made everything much clearer.
  • Fix: Method was not always taken in account.
  • Update: Accessibility and usability.
  • Fix: Field wasn’t displayed if no auto mode was selected.


  • Info: Brand new UI! Made everything much clearer.
  • Fix: Issues related to WebP and PDF thumbnails.
  • Fix: Issues related to breaking characters in the Media or Attached Post Title.


  • Fix: Issue with rare characters used in the title.
  • Fix: Issue with PDF thumbnails.


  • Add: There was an issue with Auto-Rename sometimes not appearing when the Sensitive Files Check was disabled.


  • Add: New filter ‚mfrh_allow_rename‘. Developers can now allow/reject the renaming (useful for bulk).
  • Fix: The file numbering wasn’t working fine in a few specific cases.


  • Add: Better handling of dots and hyphens (especially the non-standard ones).
  • Add: Support for WebP.


  • Fix: Little (i18n) fixes in the admin.
  • Add: Doesn’t show the button to the Dashboard if Auto is disabled.
  • Update: Admin refreshed to 2.4.


  • Fix: Column wasn’t displayed when manual enabled and automatic disabled.


  • Fix: Fixed the AJAX/REST check.
  • Update: Admin refresh.


  • Update: Dashboard and Updater… updated.
  • Fix: The WooCommerce add-on file was missing.
  • Fix: Search was sometimes not working properly in the Media Library.
  • Info: We are working on a bunch of updates concerning the usage of dots, hyphens and other characters, so expect the renaming rules to change a bit (for the best).


  • Update: Code cleaning, Youtube video.
  • Fix: Issue with updating the ALT field.


  • Update: Compatibility with WP 5.0.
  • Update: Compatibility with Real Media Library.


  • Fix: Better support for Real Media Library.
  • Update: Improved transliteration.


  • Fix: Removed Updraft.
  • Update: UTF-8 is handled by default, no need to have an option for it.
  • Add: Option for transliteration (cyrillic, accents, umlauts).


  • Add: Polylang compatibility.
  • Update: UI enhancements and attempt to make the renaming faster.


  • Add: All the actions in the Media Library are now asynchronous. No more page reload!
  • Update: Many changes and little enhancements in the code, for speed, security and code-tidiness.


  • Fix: Renaming using filters (work in progress).
  • Fix: Insensitive-case match was giving the wrong file in some cases (webp for instance).


  • Fix: PDF thumbnails support.
  • Update: Code improvement, faster SQL queries.


  • Fix: Issue with the tolowercase feature.
  • Fix: Extension issue with mfrh_new_filename filter.
  • Add: Filter to rewrite Alt Text.


  • Update: Huge code cleaning and major refactorization. The core was also rewritten.
  • Add: Compatibility with Beaver Builder.
  • Fix: Avoid looking for too much perfection (which is dangerous) when using numbered files.
  • Fix: Works fine now with image sizes in the meta which has the… same size.


  • Update: Now uploading Media into Post rename the filename accordingly.


  • Fix: Rename on Upload issue in a few cases.


  • Update: Improved Rename on Upload.
  • Fix: Annoying warning (but it was not causing any error).


  • Update: Manual Rename allows a new extension.


  • Add: Little API.


  • Add: Bulk rename in the Media Library.


  • Add: Table with the filenames before and after renaming + CSV Export (works with Redirection plugin).


  • Add: Button „Undo All“ to restore all the original filenames.
  • Fix: Avoid the Numbered Files and Force Renamed options to be activated at the same time.


  • Fix: Compatibility with WPML.
  • Fix: There was a compatibility issue with retina.


  • Add: New button „Lock All“
  • Fix: Button „Unlock All and Rename“ was not really unlocking everything.


  • Fix: Sometimes numbered files were renamed something like abc-2-2.jpg.
  • Update: Rename with lowercase to avoid issues.
  • Add: Option for Pro, Media Title is synchronized with Title of Attached Post.


  • Add: mfrh_replace_rules filter allows you to personalize the renaming at the character level.


  • Fix: Update system fixed and code cleaning.


  • Fix: Better handling of umlauts.
  • Info: There will be an important warning showing up during this update. It is an important announcement.


  • Fix: Slug was not getting renamed after recent WP update.
  • Fix: Tiny fixed to avoid notices.
  • Add: Support for WPML Media (thanks to David García froml WPML Team).


  • Fix: Should work with more plugins/themes, WooCommerce for example. The updates aren’t done only on the full URLs of the images in the DB now but also on the relative uploads path as well.
  • Info: If you have some time, please review me nicely at Thanks to you, I get a lot of motivation to make this plugin better 🙂


  • Add: Option to rename depending on the ALT. Useful if you get interesting information in your ALT.
  • Update: Sync ALT also works with Attached Post Title.
  • Fix: Better handling of norwegian letters (will improve this kind of things over time).


  • Add: Rename the file during upload, based on the media title. Not by default, check the options 🙂


  • Fix: Logging could not be enabled.
  • Update: Code cleaning.


  • Update: The UI was a bit modified and enhanced. I also think it is simpler and cleaner.
  • Update: Removed the auto-flagging process which was causing issues on sizeable installs.


  • Fix: The references in the excerpts are now also updated (they are used by WooCommerce).
  • Add: Undo button. When the media is unlocked and has been renamed, you have a Undo button. You need to active this in the option.
  • Update: Everything has been moved into the Meow Apps menu for a cleaner admin.


  • Fix: Removed Flattr.
  • Add: Additional cleaning to avoid extensions sometimes written in the title by WP.
  • Add: Clean out the english apostrophe ’s during the creation of the new filename.


  • Add: New option to remove the ad, the Flattr button and the information message about the Pro.
  • Fix: Renaming slug was not working well after latest WordPress updates
  • Fix: Use direct links for all my images and links to follow WordPress rules.


  • Info: A file mfrh_custom.php has been added. If you are an advanced users or a developer, please have a look at the FAQ here: Since I am only one developer, I can’t cover all the renaming cases we have (since sometimes plugins keep their own links to the filenames; such as WooCommerce). That will make it easy to advanced users to push Media File Renamer to cover more and more special cases.


  • Change: Modified description and information about the mfrh_url_renamed and mfrh_media_renamed filters.
  • Add: New option to force renaming file (even though the file failed to be renamed). That will help PRO users to fix their broken install, often after a migration for example (often related to change of hosting service using different encoding).
  • Fix: Click on lock/unlock doesn’t take you back to the first page anymore.
  • Fix: Little naming issue when numbering + custom filter is used.


  • Add: Lock/Unlock icons in the Media Library.
  • Add: Rename depending on the title of the post the media is attached to.


  • Update: WordPress 4.4.
  • Add: Add -2, -3, etc… when filenames are similar. Pro only.
  • Fix: There was a glitch when .jpeg extension were used. Now keep them as .jpeg.


  • Fix: There was a possibility that the image sizes filenames could be overwritten wrongly.
  • Update: Rename the GUID (File Name) is now the default. Too many people think it is a bug while it is not.
  • Add: UTF-8 support for renaming files. Before playing with this, give it a try. Windows-based hosting service will probably not work well with this.
  • Fix: Auto-Rename was renaming files even though it was disabled.
  • Update: If Auto-Rename is disabled, the Media Library column is not shown anymore, neither is the dashboard (they are useless in that case).
  • Add: Metadata containing ‚%20‘ instead of spaces are now considered too during the renaming.


  • Add: Update the metadata (true by default).
  • Fix: Guid was renamed wrongly in one rare case.
  • Fix: Double extension issue with manual renaming.


  • Fix: Couldn’t rename automatically the files without changing the titles, now the feature is back.
  • Fix: Better ‚explanations‘ before renaming.
  • Fix: Should work with WPML Media now.
  • Fix: Manage empty filenames by naming them ‚empty‘.


  • Add: Option to automatically sync the alternative text with the title.
  • Add: Filters and Actions to allow plugins (or custom code) to customize the renaming.
  • Fix: Avoid to rename file if title is not changed (annoying if you previously manually updated it).
  • Change: Plugin functions are only loaded if the user is using the admin.


  • Add: Many new options.
  • Add: Pro version.
  • Add: Manual file rename.
  • Update: Use actions for renaming (to facilitate support for more renaming features).


  • Fix: Texts.
  • Fix: Versioning.


  • Add: New option to avoid to modify database (no updates, only renaming).
  • Add: New option to force update the GUID (aka „File name“…). Not recommended at all.
  • Fix: Options were without effect.
  • Fix: GUID issue.


  • Fix: issue with attachments without metadata.
  • Fix: UTF-8 title name (i.e. Japanese or Chinese characters).


  • Add: option to rename the files automatically when a post is published.


  • Fix: the ‚to be renamed‘ flag was not removed in a few cases.


  • Fix: issue with strong-caching with WP header images.
  • Fix: now ignore missing files.
  • Change: renaming is now part of the Media Library with nice buttons.
  • Change: the dashboard has been moved to Tools (users should use the Media Library mostly).
  • Change: no bubble counter on the dashboard menu; to avoid plugin to consume any resources.


  • Fix: ‚<?‘ to ‚<?php‘.
  • Add: French translation.
  • Change: Donation button (can be removed, check the FAQ).


  • Fix: Ignore ‚Header Image‘ to avoid related issues.
  • Change: Updated screenshots.
  • Change: ‚To be renamed‘ filter removed (useless feature).


  • Change: Rename Dashboard enhanced.
  • Change: Scanning function now displays the results nicely.
  • Change: Handle the media with ‚physical‘ issues.


  • Fix: Works better on Windows (file case).
  • Fix: doesn’t add numbering when the file exists already – was way too dangerous.
  • Change: warns you if the Media title exists.
  • Fix: Removed a ‚warning‘.


  • Fix: Media were not flagged „as to be renamed“ when the title was changed during editing a post.
  • Change: Internal optimization.
  • Add: Settings page.
  • Add: Option to rename the slug or not (default: yes).


  • Fix: Works with WP 3.5.
  • Change: Update the links in DB directly.
  • Fix: number of flagged media not updated straight after the mass rename.
  • Fix: the „file name“ in the media info was empty.
  • Fix: SQL optimization & memory usage huge improvement.


  • Add: New view „To be renamed“ in the Media Library.
  • Add: a nice counter to show the number of files that need to be renamed.
  • Fix: the previous update (0.4) was actually not containing all the changes.


  • Support for WPML
  • Support for Retina plugins such as WP Retina 2x
  • Adds a ‚-‚ between the filename and counter in case of similar files
  • Mark the media as to be renamed when its name is changed outside the Media Library (avoid all the issues we had before)
  • The GUID is now updated using the URL of the images and not the post ID + title (
  • Double-check before physically renaming the files.


  • Corrections + improvements.
  • Handles well the ’special cases‘ now.
  • Tiny corrections.


  • First release.