Media File Renamer

For cleaner & SEO friendly filenames

Do you run a popular website about WordPress, photography, or do you have another way to talk about my plugin? I can share a free license against some promotion of my plugins. As you might know, I don’t do any marketing, I prefer to focus on quality and support 🙂 If you are interested, contact me

It automatically renames your media filenames depending on their titles. When files are renamed, the references to it are also updated (posts, pages, custom types and their metadata).

Media File Renamer

A new column in the Media Manager will display to you the new ideal filename and a button will allow you to rename it straight away. You can lock and unlock the renaming automatic process through little icons.

File Renamer Little Icons


By default, this is done automatically depending on the title of your media. If you have the Pro version, this can be done also based on the title of the post (page or any other custom type) the media is attached to.

File Renaming Mode

There is also a little dashboard called File Renamer in Media that will help you rename all your files at once.

Media File Renamer - Dashboard

File renaming is a dangerous process. Before renaming everything automatically, rename one or two files first and check if all the references to them are still correct on your website.

Pro version

The Pro users are given a few more features like manual renaming, renaming depending on the post the media is attached to, logging of SQL queries and a few more options. With the Pro, a good process is to actually let the plugin do the renaming automatically (like in the free version) and to do manual renaming for the files that require fine tuning.

Media File Renamer - Edit Media

References update

WordPress has so many themes and plugins that this renaming process can’t unfortunately cover all the cases, especially if other plugins are using unconventional ways. If references aren’t updated properly, please write a nice post (not an angry one) in the support threads 🙂 I will try my best to cover more and more special cases.

Custom renaming

Do you need to create your own naming rules? Every language and website is different and some of us need that. You just add some code in your functions.php, or you can modify the mfrh_custom.php file shipped with the plugin. It works like this:

add_filter( 'mfrh_new_filename', array( $this, 'filter_filename' ), 10, 3 );

function filter_filename( $new, $old, $post ) {
  return "renamed-" . $new;

$new is the new filename proposed by Media File Renamer, $old is the old one, $post is the attachment. With this, you can do virtually anything. This example is simple, it just agreed with the new filename decided by the plugin but added “renamed-” in front of it. The filename that is returned must contain the extension. If the “Numbered Files” option is enabled, a count might be added.

If you want me to create a filter for you, you can hire me here.

  • Pingback: Deux extensions pour faciliter la gestion des fichiers dans WordPress | Varia : Humeurs et découvertes d'une webmestre()

  • Pingback: Two WordPress Media Organization Insights – imho()

  • Hi

    I really love your renamer plugin. It helps me maintain a nice and clean naming structure for my images. But I have a question about organizing all the images.

    On all my sites I uncheck the “Organize my uploads into month- and year-based folders” in Media Setting, because it doesn’t make sense for me to have that kind of organization. But then I have one VERY LARGE uploads folder and maybe that is not optimal either. Eg. when the amount of images pass 2.000 then I can’t see them all in my FTP application (Transmit), and that is not so nice.

    What do you recommend in general speaking of organizing images in WordPress, and do you recommend some plugins for that?

    Thanks 🙂

    • Hi,
      Actually that’s why the files are organized by folders, to avoid this issue 🙂 You should really let WordPress creates those folders. But unfortunately there is no clean way of doing that. I am running blogs about photography, so in my case my folders are organized by year/month on which the photos has been taken and I do this through my WP/LR Sync plugin. But other than that, the default option is the best :/

  • Hi, I am thinking to buy the renamer plugin for a big media library (approximately 5000 of images). I am planning to rename the photos according to post titles. However, I am wondering how it works if the post has a several images attached? Also, will it work if post titles are not in English and using totally different alphabet (Russian – cyrillic)? Thank you very much in advance!

    • Hi! Yes, it will work, but you must make a backup before doing this on so many images. This is absolutely required. If you server supports it, turn the UTF8 option on then the filename will use the alphabets natively. Otherwise don’t, it’s up to you 🙂 Any issue, just tell me 🙂

      • Thanks Jordy! One more question – the plugin will name the files in cyrillic, right?

      • Snaptechy

        Hi Jordy – I’m interested too by your plugin, how the plugin willl manage renaming different images part of the same post ( based on the post title). Thxs

  • Hi

    The pro version sounds really interesting, does it work for featured image in Woocommerce Products? How does it handle product gallery images?


    • Arkymedes

      I’m curious about that too.

      • Hi guys! In all my tests, it works. Please try it. If it doesn’t, contact me and we’ll find why 🙂

        • sanjay

          Hi, I am using this plugin on WooCommerce products renaming but I cant see the products now. What my be the issue? Pl. suggest asap.

          • You mean, the photos of the products? Where were they used, in which part of WooCommerce? And meanwhile, you can use the Undo function in the Media Library to rollback to the previous filename.

          • sanjay

            yeah. I am using on the photos of the products. I have renamed the photos to seo friendly but now they are not showing up.

          • This requires a lot of debug, Media File Renamer has been working with WooCommerce with all my tests but of course I can’t cover all the cases by myself. You should use the Undo function, or use the backup you should have made in the case you used the bulk function.

          • sanjay

            Undo facility provided by you is not showing up all the renamed images, it shows up on some images only.

          • The plugin capability depends on a lot of other things, like all the plugins you are using, and potential errors caused by the server or any other plugin. The bulk function is not safe and this is why the plugin asks to make a backup before using it. It you have it, use it, otherwise you will need to delete the images and re-upload them.

          • sanjay

            I have not used Bulk renaming option but I will suggest you not to put any risky option in the plugin. People always tend to save time and may be in losses due to not so sure options. I am uploading the images with new or edited names now.

          • Actually I agree with you. I really dislike adding risky options, but users ask them to me and they are mostly developers and aware of the risks. For standard users I need to add warnings but I can’t remove them. I also learn with time to add risky options to the Pro versions of my plugin and to avoid having them in the Free versions; interestingly the users of the Pro versions are usually way more careful.

          • sanjay


          • sanjay

            Ok, Public Demand should be respected always 🙂

  • Arkymedes

    Hi there, I’m very much interested in your plugin but I have a question related to Product Images and Galleries used in WooCommerce. Can the plugin rename the main product image and associated gallery images based on the Product Title?

    Thanks so much!

  • Adam

    Hi Jordy, i bought the Media File Renamer last year and it seems now the Pro version is disabled. Now i need to get the yearly subsription?

  • Lizaza

    Hello, I’ve purchased a pro version and added the info about the site at the admin panel, but still don’t know how to activate it on the blog. Please help

  • TimT2011

    Hi Jordy, for some reason I thought saw that Media File Renamer was compatible with Themefusion Avada when I purchased it. It seems while the images outside of Avada (like Featured Images) are updated correctly with their new file names, those referenced within Avada do not get updated and show up as broken. Do you know if it’s compatible or could I just be doing something wrong? I tried regenerating thumbnails, but that did not help. Thanks!

    • Hi! How are images referenced by Avada? Through a plugin or a specific builder?

      It’s not surprising that it might not work to regenerate the thumbnails – the renaming was actually successful, it is just that the plugin/system you are using with Avada cannot reference it. Let’s look at this, don’t hesitate to contact me directly.

  • Rich

    Not sure if this is possible, but have a need to re-link some of my media to an outside server. I thought the Pro plug in could do this, but the media URL field still remains uneditable.

    Is it possible to re-link an existing media file to a location on another Web server?

  • Fernando O.


    I purchase the Pro version to rename media with the ALT text, but I capture the ALT Text in each post not in media library is there a way to rename media with de ALT text that have in the post?


    • Hi 🙂 The ALT text used to rename the Media is the ALT text on your Media, of course. If you modify the ALT text directly in your HTML (if I understood you right), there is no way the plugin can see that unfortunately. You need to update your ALT (and all the other information) in your Media.

      • Fernando O.

        Thanks for the reply Jordy, I understood that the pro version could do it, I rename manually the ALT text for all the images with you plugin Media ALT renamer and then rename all the images with file renamer… It took me longer than I thought but in the end it was already. Thanks you have goods plugins

  • I am in the Media library and have a number of photos i want to rename. Simply doing one at a time is not possible and I do not want to rename ALL 8000 images on my site. Is there a way to select a few in the library and rename in bulk?

    • Unfortunately right now there is no way to do this, WordPress doesn’t let developers naturally hook into those little checkbox, which is really… annoying 🙂 I could hack into it and add the feature but it could break quickly and easily so I am waiting for WordPress to allow this officially. The other way is to lock the files you don’t want to be renamed, let the other unlock, go in the Renamer Dashboard and click on Rename All.

  • Kaya

    If i understood right, the pro version can automatically fetch the post were the media attached is and then change the media title, filename and alternative text to same as post title?

    • Exactly 🙂

      • Kaya

        I saw, the post were the media attached is, doesnt save the new media filename. Maybe you can add this feature in your future updates 🙂

      • Kaya

        I saw, the product were the media attached is, doesnt save the new media filename. Maybe you can add this feature in your future updates 🙂

  • Marcio Santos


    1- Is possible rename images the woocommerce products automatic?
    2- Instead get name the post is possible get name the one custom field?


I recommend you to use WPEngine or SiteGround. They are both excellent hosting services and work perfectly with all my plugins.