Support for Easy Upload Renamer for WordPress


P_Enrique supports this item


Popular questions for this item

Can I use this plugin to quickly make my filenames search-engine optimized?

If you want sanitizing and SEO functionality only, turn OFF the option Use the post title as the attachment title. Now, if you set the Prepend String to, for example, “myfoodblog” and then upload a file called “Smörgåsbord with Crème brûlée.jpg”, the file is renamed to myfoodblog-smorgasbord-with-creme-brulee.jpg, and the attachment title is set to the original filename (minus the extension). (See this FAQ for details about what happened with the accented characters.)

What happens with the Title and the ALT text?

The plugin sets the filename based on the post title.

You can choose an option to set the “Attachment Title” property to be the same as the post title (with numbers, optionally). The “Attachment Title” property is automatically used by WordPress as the ALT text, unless you manually specify some other text. In other words, if you want to use the post title as the ALT text, do not fill in the field.

This plugin doesn’t do anything with the “Caption” and “Description” fields. From SEO point of view, repeating the same text that’s in the ALT property would make no difference.

Why are my files are not renamed when I upload them to the Media Library?

Renaming by post or page title will not work if you are uploading the files directly to the Media Library. Since there is no way of knowing to which post your files might be attached to in the future, so this behaviour is normal. The prepend string will be added, however, and other filtering (such as stripping accents from the filename) will take place.

I’m uploading to a post or a page, but the file shows the old name, why?

The original file name will be shown during the upload. The new one will appear when it’s completed.

Why wasn’t my file renamed after the upload completed?

Did you choose to rename files using the post/page title and/or set a prepend string? If you didn’t, there was nothing for the plugin to do! Set your options at the WordPress Settings > Media screen.

I get a message telling me to set a title, but I already did!

Sometimes the post or page title isn’t updated on the server immediately, click on Save Draft to update it.

I changed the title but the files are not renamed, why?

If you upload files and then change the post or page title, the uploaded files will not be renamed. This plugin only renames files as they are uploaded.

Why are my files appearing in another order?

If you are uploading several files at once, the order in which the files will appear is beyond our control as it depends on the browser used. Different browsers send the files in different order, and WordPress processes them as they come in. If you need the files to be in a certain order, you need to upload them one by one.

What happens with Non-Latin characters, such as Cyrillic, in post titles?

Non-Latin characters mean letters that are not based on the A-Z alphabet, such as Chinese, Arabic, Thai, Cyrillic, Greek, Hebrew, to name just a few.

Short answer: The plugin handles these scripts just as WordPress does, with a little bit of extra care.

Long answer: Let’s assume you write your post titles in Russian or Arabic. When you upload something to your post, the process goes like this:

  • The plugin tries to rename your files using the title you wrote. Everything that can be converted to basic Latin characters will be converted, such as “à” (Latin letter a with grave) to “a”. All symbols, punctuation etc. will be converted to dashes (minus-signs).
  • If you are on a Windows-based server, the next step is removing all non-ASCII letters from the filename. This means all letters that are not the A-Z Latin alphabet. (Otherwise WordPress won’t be able to show your file or link to it. This is an incompatibility between PHP – the scripting language behind WordPress – and Windows.)
  • If after stripping punctuation, and, in case of Windows, stripping letters that could not be converted to simple Latin letters, there are less than 5 alphabetical letters left, the plugin will try rename your file using the post “permalink” instead. Unfortunately, this step only works for posts that are published.
  • If there is no useful permalink either, the plugin will use your original filename instead (as it was on your computer).
  • If the original filename cannot be used, you get an error message. (This should only happen when you are using the “ASCII” filter; unfortunately, it is the only one available on a Windows server.)
    NOTE: This plugin will not make files work if they didn’t work before. It does add an error notice when this happens; see the question `Why do I get an error that says “Could not rename the file”?` below. Before asking for support because of a broken file upload, please disable the plugin and try to upload the SAME file again. If a file doesn’t work without the plugin, we cannot magically make it work.
  • If you are on a Unix-based server (most common!), the Non-Latin characters will stay as they were, provided that you have not chosen the “ASCII” filter and are using the “UTF-8” filter.

Will my transliteration plugin work with this plugin?

If you have installed a plugin that transliterates a Non-Latin script to ASCII characters, it should work with the Easy Upload Renamer, provided that the plugin works as a filter for the WordPress hook sanitize_file_name. (If your filenames are transliterated when you upload them without this plugin, the same transliterations should take place with this plugin active.)

Can I choose not to have my filenames in lowercase?

To enable compatibility with the advanced filtering of accented characters and punctuation, all filenames are always converted to lower case. This is also the current consensus for SEO (Search Engine Optimization) purposes.

Why do I get an error that says “Could not give a usable name for the uploaded file”?

This is an error message that appears when there are no valid characters to use in the filename. The plugin tries to rename your file using the post title, the permalink (slug), and finally the original filename.

  1. When using the “UTF-8” filter, the post title and the original filename contain only numbers renaming using the post title, the title contains only punctuation characters, symbols etc. The plugin detects this and tries to use the post permalink instead (for published posts). If this fails as well, the plugin uses the original filename (the name of the file on your computer) instead. But if there are not enough usable characters in the original filename either, you get this error message.
  2. You are using the “ASCII” filter (which is the only one available on Windows-based systems) and both the post title and the original filename contain less than 5 ASCII letters (Latin A-Z letters).
NOTE: Please note that this error message is a courtesy from the plugin. The plugin goes to extra lengths to try to make your files work. Without the plugin, WordPress would let you upload whatever, and you’d just get a broken image file (and broken thumbnails in your uploads folder). The error message is advising you about this situation so you can avoid it.

What is the maximum length of a filename?

When using title renaming, you can limit the characters used from the title in the plugin settings, with 0 meaning “unlimited”.

But there are fixed maximums, of course, since a filename cannot be indeterminately long.

There are two kinds of limits here: characters and bytes. When filenames contain Non-Latin characters, each character may take up to 5 bytes of storage space in the UTF-8 encoding. (Latin A-Z characters take 1 byte per character, accented characters take 2, other scripts take more.)

The prepend string is capped at 32 characters and 50 bytes, whichever is less.

The base filename string is capped at 192 bytes. (The number and extension may take up to 8 bytes more.)

The separator symbol is capped at 1 character and 5 bytes. In fact, you can only choose a dash (a minus-sign) or an underscore (both take only 1 byte), but there’s some slack for a future update.

So that’s a total of 255 bytes. However, the plugin will truncate the filename string automatically depending on the maximum path length on the current system. (Windows has a limit of 255 characters per path and some of these characters are used in the path of the uploads directory.)

Show more

Contact the author

This author provides limited support for this item through this item's comments.

Item support includes:

  • Availability of the author to answer questions
  • Answering technical questions about item’s features
  • Assistance with reported bugs and issues
  • Help with included 3rd party assets

However, item support does not include:

  • Customization services
  • Installation services

View the item support policy