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.

Buy the Pro version

Get Media File Renamer Pro

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


    • Hello Marcio! Yes, it renamed featured images. It’s difficult to get that from a custom field, I could add this as an option but since you are the first to ask for it, it would be a lot of work and support for only one request, but I might do it someday if somebody asks the same thing 🙂

      • Dan

        It would be a great option!

  • Steven Zussino

    Can this work with other post types as well? I can only get this working with Posts.


    • Totally. Actually a post, page or any other post type is technically exactly the same for Media File Renamer. I am not sure why it wouldn’t work with another type of post type in your case. You need to link your media to that post type and that will work with the title (I guess that’s what you do). If not, contact me directly.

      • Steven Zussino

        The logging page goes to a 404. Is there a manual for this at all? I have the pro version.

  • Hey Jordy – thanks for all your work, the LR/WP plugin is incredible and I wouldn’t be able to handle/organize the amount of photos from Lightroom to WordPress any other way.

    I had a question about the file renamer. Is it able to read the Lightroom filename and update the WordPress filename? I synced photos to WP but batch changed the names in Lightroom and want the file names to reflect in WP. Republishing them doesn’t change the names, but I’m hoping this has that ability?


    • You are welcome 🙂 The original filename of the media in LR is totally unknown to the file itself and to WordPress. The export settings (in the LR plugin) are used to generate a filename (that can be equal to the original one though). The only way would be to use Media File Renamer in Manual mode and do it… manually. WP/LR Sync creates the filenames at the beginning but after that, it doesn’t modify them, that would be way too dangerous.


    please i really need this

  • Steven ŖöĦǟn Malip

    How much is the PRO???

  • Since a view days some files get renamed to hello-*.jpg, which is not very nice. I am using the free version. There was an update currently. Is this the way to push me to buy a pro version?

    • I would never such a thing, that would be unbelievable. There was the filter examples included by mistakes with one release, but it only was for a few hours, the latest version doesn’t have that. Can you maybe try to delete the plugin and re-install it again?

      • Thx for the reply and I will try it. I thought, this could be, because it startet just now after the update and in the media-file-renamer.log there is some evidence … 2017-08-14 08:50:03: ** Rename Media: logos_050917.png
        2017-08-14 08:50:03: New file should be: hello-logos_050917.png

        Maybe a bug?

        Best regards & Thx

        • Make sure you delete the plugin and really install the latest version. That was a version with this bug, I think it’s the one you are using.

          • It seems to work. But how does I get the changed filenames renamed again?

  • Luigi Belluschi

    Hi I get this error when I validate my key

    Server IP:
    Google GET: OK
    MeowApps GET: WP_Error Object ( [errors] => Array ( [http_request_failed] => Array ( [0] => cURL error 28: Resolving timed out after 5000 milliseconds ) ) [error_data] => Array ( ) )
    MeowApps STORE:


    RESPONSE: WP_Error Object ( [errors] => Array ( [http_request_failed] => Array ( [0] => cURL error 28: Connection timed out after 10000 milliseconds ) ) [error_data] => Array ( ) )

  • Michael Corcione

    Does this plugin work with Woocommerce?

    I’m currently running the pro version and was hoping that when I upload the files to a product that I’m adding it would rename the files automatically. I have the box checked for rename on upload and the title post option selected but it doesn’t seem to be renaming on upload.

    The products I am adding are products I’m scheduling, not instantly publishing or already published.

  • Hack

    I am using free version of this plugin. The bulk rename process started past and I have arround 7000+ images. Suddenly the process slows down at 500+. What could be the reason. I wish to buy the pro version. I do not any issue with logs

  • Si

    Hi Jordy,

    Been using Media File Renamer since last year, all good, but just the last couple of weeks it’s started inserting the word ‘hello’ at the beginning of every file name when I rename them e.g. instead of ‘tokyo-shinjuku-1’ it’s changing it to ‘hello-tokyo-shinjuku-1’. Any idea why, or how to stop it?


    • Hello! There was an issue with a previous version. Can you please uninstall the one you have and re-install it? It looks like you are not using the latest version. Then it will work 🙂

      • Si

        Hey, thanks for getting back to me… that did the trick perfectly – and I slapped my forehead for not having tried it myself already!

        Also while I’m here just want to say Offbeat Japan is an awesome site, I’d linked to it from my own blog already (and surely will again) and I’ve just realised I’m talking to the same person who runs it – nice work mate!


  • Ed

    Jordy, is this app compatible with woocommerce? I have installed the app, renamed files via “auto” and the name changes will not take effect. I am thinking this is a woo commerce issue?

    • Normally, this plugin is compatible with WooCommerce. But since I am not using WooCommerce personally, I can’t tell for sure, and I know that there are many plugins relative to WooCommerce that can even make the situations trickier. Can you contact me directly so we can go over those issues?

  • Antoine Verdier

    Hi Jordy,

    There is something wrong I did not get. I renamed all the images of the website. When I look into the Medias names have been changed properly. But when I do a right click on the image in the site, it opens with its old name?!

    For example: the page is :
    A right click on Peter Lane first photo you get this link :×1024.jpg
    But the name of the photo has already been changed to

    Can you help me, thank you.


  • gerard

    Hello. If I change the name of a photo, uploaded with WP/LR, will there be a conflict with Lightroom? Will WP/LR consider it as the same photo as the one in Lightroom even if they don’t have the same name anymore?

    • Hi! No problem at all 🙂 The sync is not made depending on the filename, but on the identifier (internal ID). No worries 🙂

  • Adam Langley

    Hi I have changed the activated site to the correct one for the pro version of this plugin from the licenses page yet I still cant use the plugin, I keep getting an invalid lisence error.

  • Bente

    I´cant open setting after installing and activating the plugin. I would like to enable manual rename in the settings…

    • Did you contact me through the support form? What is the problem? Did you disable the free version? Can you see the Meow Apps Menu with the Renamer menu?

      • Bente

        Hi Jordy

        The free version Was inaktive when i installed the pro version
        I copyed the keyboard into the plugin and humpede over the settings. And now i Cantona open the settings anywhere. When i push the editor button i go to the php
        How do I open settings again?

        Best regards

        Hent Outlook til Android


    hi i bought the pro version and at the license page i put the url in and got active. When i deleted the renamer plug in and downloaded it again, it said pro version is disabled, how do i upgrade to pro version

    • Hello! You need to download the plugin from the link you got when you bought it (or by accessing your account on the store If you download if from the WordPress Repository, that’s the free version and you can’t insert the license key.

  • Midori

    Today installed and activated pro version successfully. In settings I ticked both .log files to be active. Before renaming any media. I decided to pick a test.jpg which is commonly attached to various pages, posts, gallery or slider templates. Firstly I attampted to complete Caption, Alt and Description fields for test.jpg. The fields were saved correctly, however the following error message was displayed like there is some kind of proble creating two .log files.
    Should I disable options for auto log files?

    failed to open stream: No such file or directory in /homepages/3/d560338515/htdocs/clickandbuilds/TWF2/wp-content/plugins/media-file-renamer-pro/core.php on line 748

    Warning: fwrite() expects parameter 1 to be resource, boolean given in /homepages/3/d560338515/htdocs/clickandbuilds/TWF2/wp-content/plugins/media-file-renamer-pro/core.php on line 750

    Warning: fclose() expects parameter 1 to be resource, boolean given in /homepages/3/d560338515/htdocs/clickandbuilds/TWF2/wp-content/plugins/media-file-renamer-pro/core.php on line 751

    failed to open stream: No such file or directory in /homepages/3/d560338515/htdocs/clickandbuilds/TWF2/wp-content/plugins/media-file-renamer-pro/core.php on line 748

    Warning: fwrite() expects parameter 1 to be resource, boolean given in /homepages/3/d560338515/htdocs/clickandbuilds/TWF2/wp-content/plugins/media-file-renamer-pro/core.php on line 750

    Warning: fclose() expects parameter 1 to be resource, boolean given in /homepages/3/d560338515/htdocs/clickandbuilds/TWF2/wp-content/plugins/media-file-renamer-pro/core.php on line 751

    Warning: Cannot modify header information – headers already sent
    by (output started at
    in /homepages/3/d560338515/htdocs/clickandbuilds/TWF2/wp-includes/pluggable.php on line 1210

  • Simon Hawketts

    I have the Pro version of media file renamer installed on one of my vintage photography sites and found it to be a great help fixing some seo issues with poorly named files from scans.

    Although I did a bulk rename, there are still occasions when I edit a post (well it’s a custom post type actually) when I want to rename an image file, but to do that I need to drop out of the post edit screen, find the image in the media library and then initiate a rename. I was wondering if there is an action set up which I can call from within my plugin code to rename a media file?

    I have a text box which is populated with the current filename, and a radio button to select the renaming action on save so what I’d want to do is change the filename in the text box, select ‘rename’ from the radio button and then in the save_post action call the rename action.

    Does this sound doable?

    • Hi Simon. Yes, I just pushed a new version (3.6.8) with a tiny API in it. Update to it, then from your code you can call this: mfrh_rename( $mediaId ). That will auto-rename this media depending on your settings. Give it a try 🙂

      • Simon Hawketts

        Hi Jordy
        Now that’s what I call support – create a feature just before someone realises they need it 🙂

        I’ll give it a try – thanks very much!

        • Haha, thank you 🙂 I actually read your comment first, then added this into the plugin, it was actually not part of my plan 🙂 I hope it works.

          • Simon Hawketts

            I’m afraid it doesn’t seem to work. There is a warning about a missing parameter (the $attachment parameter in rename_media) and then I get other warnings related to another plugin I have (media library assistant). I’ll run through it with a debugger later and see if I can see what is wrong.

          • Simon Hawketts

            Hi Jordy

            My issue with media library assistant is because I have an action running when an image file is changed and that is causing problems.

            I’ve turned that action off and as long as I create my own version of the api you created and call rename_media directly, passing null for $attachment, it seems to be doing the right thing. All the other issues I have with it are not down to your plugin so I can’t ask for more.

            You may want to set $attachment to null in the method signature or pass a null value in.

            Thanks for supplying this extra functionality – much appreciated

  • Arijit Biswas

    I need your opinion. I’m currently using the Free version, but I really wants the “Post Title to Image” so, I’m considering purchasing the Pro version. But my database is huge as stated here – – I also tried the bulk renamer feature, but I have to say it’s very very slow, if I keep my laptop running it will take 2-3 weeks to rename all the images. So, is there anything which can be fast? The bulk rename feature works one by one, what if it can do parallel?

    • With Post Media off, is it usable for you? If yes, then the Post Meta option will also be optimized 🙂 If that’s the problem, it will be fixed soon. Parallel wouldn’t be good to do, your server would agonize 🙂

      • Arijit Biswas

        Yes, I’m using Post Meta Off, because all of them are feature image, so I don’t having a problem. But the real problem is, bulk renaming.. my server is really fast, no doubt in that, but the process itself is slow. :/

  • Mike_McKoy

    Hi there, on my company website the images are not coming up in the attachments page after renaming. In fact i’m getting 404 errors. Can you help me understand what to do? I have the pro version. The page in question is

    • neon

      Hi Mike, I have the same problem. Would be great to get some advice!!
      It seams with the plugin and the renamed images, the links changed – so the images can’t be found.

    • Please contact me directly, make also sure your reset your cache (plugins and all).

  • neon

    Hey there.

    great idea and plugin.
    I did automaticly change a few filenames. It worked.
    But the images don’t show up on the website. It’s just a white nothing.
    What can I do?
    Thanks in advance. Would be so great!

    • neon

      No ideas?

      • Many things could happen here, did you check the cache? Please check the WordPress forums, if you are a Pro user you can contact me directly.

  • José Luis Muñoz Sánchez

    Hello, good morning from Spain. I have the free version of the Media File Renamer plugin and when I give it to rename all it is blocked by taking about 2000 photos.
    In total I have 20,000 images. Is it blocked by having so many photos? Is this solved with the pro version?
    Thank you.

    • Hi! There is no limitation because it is a Free version, the Pro version only has more options, that’s all. You mean the plugin freezes during the rename? Did you check your PHP Error Logs?

      • José Luis Muñoz Sánchez

        If you prefer, we will discuss it here. Yes, it freezes when it has renamed some 2000 images. He stands still and nothing, I have to start over.
        I do not get any error log.

  • Nico Morgan

    Just bought the PRO version because I had got good use out of the free one. Thank you.

    I found the Scan All and Show Issue button useful because I then had a list of all the files which the plug in thought I needed to change. I could either right-click and edit the media by hand (if I disagreed with your ideas) or go ahead and click on the auto button.

    BTW the bulk updater button scares me! How do I know what changes it will make in the background? The number of locked files is far fewer than the number I have changed by hand either through the plugin or otherwise.

    I tried doing it in the media library as you suggest but found that annoying because I might be on page 26 of 51 before I found a file which needed renaming and when I click the auto button it resets to page 1 again. Grrr.

    Does the act of changing a filename mean that any posts which reference that file get changed automatically i.e. no need for redirects, or should I import all the changed files into Redirection plugin as well? This seems clunky if it is not necessary.

    Also, after changing the files I have kept an eye on my 404s and a few keep coming up. How can I check where the link to that file is?

    • The Bulk does exactly what the “Auto-Rename” button does. It just runs it on all your Media, so please make a backup first. If you are scared, don’t do it. If you have a backup, then it’s safe 😉

      It depends, but in the Renamer Dashboard, the last section shows you the previous filenames and the new filenames and you can export a CSV. This CSV can be imported in “Redirection”.

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