FAQ

My images are broken

This is the most obvious issue you could encounter when using a plugin that renames/alters your files. Well, you should have made a backup before so restore broken. If you don’t understand how technically they could get broken, the answer is in the section below “Update of the links”. If have no backup, then there are two things you can do:

  • Un-rename those files (= undo). There is a Undo option in the Advanced Settings of the plugin. Enable it and visit your Media Library. In the Rename column, you will notice a red arrow to come back, to undo. Use it.
  • Install the Regenerate Thumbnails plugin and run it on those images (or all your images)

General Issues & Questions

In the Media Edit, the ‘File name’ doesn’t change!
Yes, this is a WordPress issue. This “File name” doesn’t come from the real filename but from a database entry called GUID. This GUID should be unique and is only managed by WordPress. Before, the plugin used to modify this GUID accordingly but recently WordPress tries to prevent the plugins to do so. After some research, it appears that modifying this GUID is a very bad idea after all (please check this URL: http://pods.io/2013/07/17/dont-use-the-guid-field-ever-ever-ever/). In short, don’t think this “File name” as an actual filename, it is not. It is an identifier.

I added an option (check the plugin settings) if you really want to rename it but you actually shouldn’t.

The input box where to edit the filename is grayed out.
You need to have the Pro version activated. Also, in your settings (WP Admin > Settings > File Renamer), you need to have Manual Renaming enabled.
I have problem renaming filenames with accents.
Did you migrate your files from one server to another? This might have create an encoding issue between your files (DB and filepath has a different encoding). This user found a solution to this issue: https://wordpress.org/support/topic/did-everything-right-except-remove-accents-bought-pro-to-manually-override?replies=5.
What the option ‘Rename on save’ does?
Let’s say you modify the titles of your media while editing a post. The plugin cannot rename the files yet, because you are in the process of editing your post and the image links are in there. If that option is checked, when the post is actually saved (drafted, scheduled or published), then the images will be renamed and the links updated. If you don’t check this option, you would have to go to the Media Manager and click on the button “Rename Now” next to that image.
I am using Woocommerce. After renaming, the featured image for my products are broken. What can I do?
You should try to re-generate all the thumbnails. Have a look a this thread: Media File Renamer + WooCommerce.
How do I get rid of the banner?
You can add this line to your wp-config.php (main config file) or in your functions.php (theme).
`define( “WP_HIDE_DONATION_BUTTONS”,  true );`

Custom Renaming

We are all using different languages and our websites have different topics. Therefore, there are unlimited ways of automatically renaming filenames. Media File Renamer does it simply depending on the title you gave you the media. If you want to customize it, the best way is to implement this customization. You will need to be a developer of to get one to do it for you, but this is not too hard. The code below, for instance, will add “renamed-” in front of the filename proposed by the plugin. The $old filename is still accessible, and there is a reference to the attachment through the $post variable.

add_filter( 'mfrh_new_filename', 'my_filter_filename', 10, 3 );
 
function my_filter_filename( $new, $old, $post ) {
  return "renamed-" . $new;
}

Another filter allows you to do specify rules at the character level (but you can also specify whole strings).

add_filter( 'mfrh_replace_rules', 'replace_s_by_z', 10, 1 );
 
function replace_s_by_z( $rules ) {
  $rules['s'] = 'z';
  return $rules;
}

Update of the links (references)

There are many themes and plugins available. Some of them use images, created their own meta hidden somewhere in your database or at some uncanny locations. Unfortunately, Media File Renamer cannot guess all those. If you rename a file, one of those references might get broken.

If you know how to update the references, you can use the “mfrh_url_renamed” (if you want to handle the new URL for this filename) or the “mfrh_media_renamed” (if you want to handle the filename on your server).

For instance, here is the code to update the post meta. This is actually already part of the plugin.

add_action( 'mfrh_url_renamed', 'action_update_postmeta', 10, 3 );
 
function action_update_postmeta( $post, $orig_image_url, $new_image_url ) {
  global $wpdb;
  $query = $wpdb->prepare( "UPDATE $wpdb->postmeta SET meta_value = '%s' WHERE meta_key <> '_original_filename' AND (TRIM(meta_value) = '%s' OR TRIM(meta_value) = '%s');", $new_image_url, $orig_image_url, str_replace( ' ', '%20', $orig_image_url ) );
  $wpdb->query( $query );
}
  • Kurt Scherer

    https://uploads.disquscdn.com/images/6052bd0fe46d6365320104443eecae349774c9575bfa026f627c052a7824778e.png

    Downloaded the File Renamer plug-in and activated it it. Opened my Media files and it was there. Next time days later it was gone. I deleted the original download and reloaded it from the WP plug-in directory, then activated it but it’s still not showing up anywhere. Any idea of what is happening? I had just paid for the Pro-version before noticing it wasn’t there anymore.

    • So it’s active but not showing anywhere? Do you see the menu “Meow Apps” at the bottom of your menu in the WordPress Admin? Do you see the File Renamer there and its options? Also, in the Media Library, the renaming buttons are displayed in a column, maybe it has been made hidden? You can click on Screen Options (top of the screen in the Media Library) and make sure it’s checked.

  • TimT2011

    Hello. I’m only interested in the manual file renaming aspect of your plugin and am trying to decide if I should purchase. I noticed under Side Updates it says to give it a try it might work… This would be extremely important aspect to work for me as each image is referenced multiple places and having to fix each one would be time consuming. Are there certain known instances where it doesn’t work? Is it theme related? If so, do you know if it works with Avada/Theme Fusion? Thanks!

    • Hi! It works fine with any themes, but if you are using a special gallery system or a plugin that does the images in a different way, it might not work as nicely. Best is to try, careful on the first renames, and if it works, adopt it. Don’t worry, if it doesn’t for you I will just give you a refund.

  • Brandon Hughes

    Hello, I have been using your app a couple of days now, very happy with its function. It does exactly what you said it would, thank you! I am dealing with thousands of images and when I rename images more then 4-5 at a time (clicking button in media library) it times out or I get server error. I have reset server time to 8000 sec, and have plenty of space. Is there anything I can do to allow more images to be renamed at one time? Thanks

    • Hi! Unfortunately not, you should do it one by one, otherwise it’s complex. Or go through the Bulk Rename and do it this way. Why not the Bulk?

      • Brandon Hughes

        I was going to do the bulk but thought I would try it one at a time and then 3-5 to see how it goes. When it started to time out with 3-5 I thought the bulk would not work at all. I am guessing from your question that bulk will work differently and can handle the large load, is this correct?

        • Actually, wait, how do you rename 4-5 images at the same time? It’s not possible, you need to click on the Rename button every time. What Bulk does is that it basically click on this button for all the Media, one by one. So basically it times out in your case when you do it one by one? Randomly?

          • Brandon Hughes

            Hi Jordy, I load about 10-15 events, each with an attached image. I then go to the media library and click the rename button. I do it one by one now but before I was clicking 3-5, one after another, and then it would time out. Does bulk click on them one by one, after, the last one has been loaded? If so, I may give it a go.

  • Danny Scott

    Hi, we just installed this plug-in on our site and it appears to have renamed some of my files automatically without being triggered. Is this the case or is it recognizing naming structure that already fits it format and assuming it has already been automatically renamed?

    • Hi, it shouldn’t do that, except if you click the option Rename on Post Save (which I don’t recommend at all). Also, it renames files if you modify their titles (if that’s what you have decided in the options).

  • What happens when I purchase PRO, use the auto rename feature and an image is attached to another post?

    • If the Auto Rename option is set to Attached Post, then it use the title of this Post as the new filename.

      • The question is more inline with what if I attach that image to another post. 1 image 2 posts

  • Alain Azzam

    I’d like to understand where is the bulk rename function. It’s nowhere to be found in my installation. Do I need the PRO version?

    https://www.screencast.com/t/FRmMMv1o

    It is *not* under the Bulk Actions dropdown.

    • Alain Azzam

      Ok I found it, it’s in a different screen (not very intuitive, I suggest to modify this). But I have 1,800 files to rename. I will backup and try it but I’m sensing that a timeout will occur.

      Also, we have issues with some characters like _ in our code but your plugin keeps them. We’d like the automatic renamer not to use that character. Suggestion: add a field where we can specify the “unauthorized characters”.

  • Adam Little

    Hi I purchased the pro version of the remaner but can’t seem to find the instructions on how to upgrade from the free version?

    • Adam Little

      I have now removed the old install downloaded the new .zip folder but I am receiving an error message “Missing a temporary folder.” when I try to install. Can you suggest anything to upload the file?

  • Dizzy Bryan High

    Hey There I have the Pro Version of the plugin.

    After renaming files references to them in my custom post types are not updated.

    Can you explain how to update them automatically when a file is renamed.

    The demo code you have for updating references has some weird characters. and does not seem to be valid code.

    My Custom post Types use CMB2 (custom metaboxes 2)

    • Hi! The fact it is custom types is not the problem, it is something else. However, you mention metabox, and this is not a custom type, it’s a custom metadata, and those are totally different. Can you contact me directly? We need to look how this information is stored otherwise the plugin can’t see it at all.

      I fixed the weird characters by the way 🙂

  • Nate Rooks

    Hi Jordy – having Media Renamer Pro has been a huge benefit for our WordPress page.

    For a while, I could rename image files, then reload the post, and the files would all be changed and show up as before.

    Now, the image files in the posts are not updating, so I have to go in and relink/copy/paste/etc. Am I doing something wrong, or does the automatic updating just only work sometimes? Thanks!

    • Hi Nate. Are you using a Page Builder? Of course Media File Renamer renames the files in the posts by default, unfortunately most Page Builders use their own system and my plugin would need to have specific code for every single page builder to support them. It’s doable, just a huge amount of work.

  • Saymon

    I ran the batch rename and it shows as if it worked, actually I get the green arrow in the Media library, but the images were not renamed at all. Since the plugin shows that the image was renamed, then there is not option anymore where I can rename again.

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

    Cheers

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