Documentation for the File Renaming on Upload – WordPress Plugin plugin.

File Renaming on Upload – WordPress Plugin

Author: WPFactory PluginsVersion: 1.3.8Updated: 8 months ago
Requires WordPress version: 4.0Tested up to WordPress version: 6.2


File Renaming on Upload is the premium version of free File Renaming on Upload plugin with some extra features making it more awesome.

The main purpose of this plugin is to fix problematic file uploads with accents or special characters. An essential plugin for non-english websites.
Besides that, it can improve your SEO adding some relevant info to your filename, like your domain name or the post title your file is attached on.

Besides the features that will be already bundled from the free plugin,
check the available features on this premium version:

Edit filenames and permalinks manually

WordPress doesn’t allow to edit filenames and permalinks natively. With this feature you are no longer limited to that

Once you enable “Change filename manually via dashboard” and “Change permalink manually via dashboard” options on plugin’s settings there will be displayed the following Metabox on media file page.

File Renaming on Upload Admin

Change it as you like, but you have to use a unique filename.

Note: Renaming images will not update references to them. So if an image was attached as post content you will have to update posts using that image as well.
Yet, featured images or any images that are referenced by their IDs will not require any update on their parent posts

Update old media

Once this plugin is installed and enabled you aren’t going to have upload problems anymore with accents and special characters, but what if you or your client already have some buggy images uploaded before installing the plugin? Now you don’t need to worry anymore!
All you have to do is select them on media library and choose update filename located on bulk actions.

File Renaming on Upload Backend Update filename

Note: After you click the Apply button, you don’t need to stay on the same page waiting the background process. You can navigate normally.

Autofill ALT tag

After uploading images, their own filenames will be registered as the ALT attribute. In other words, if you upload an image called My Cat.jpg it will have its alt tag automatically filled like <img alt=”My Cat” />.

This feature can improve your SEO, so try to create descriptive names to your images before uploading them.

Custom field rule

This is a new kind of rule.
If you have a custom field on your post and upload an image, it will be renamed according to this custom field if you want.
A practical example:

  1. Create a rule {cf:_myfield}
  2. Create a custom field called “_myfield” for some post
  3. Fill this field as “Test”
  4. If you upload an image to that post, the image will be renamed according to the field value, so it will be called test.jpg

New rules

New filename rules will always be implemented as the plugin gets updated.
For now, besides the free rules, you will have

  • User ID – Gets current user id
  • User Role – Gets current user role
  • User Name – Gets current user name
  • Product SKU – Gets SKU from a WooCommerce product if possible
  • Post Slug – Gets post slug
  • Post ID – Gets post ID
  • Custom string – Adds a custom string to the filename

Taxonomy rule

This is a new kind of rule.
The file will be renamed according to the post terms of a specific taxonomy.
e.g. {tax:category}

Jpeg to JPG

Renames filename extension from jpeg to jpg.

Update media on post update

Updates media filename from a post (including custom post types) when it gets updated.
Will only work on attached media.

Schedule Filename Update

Schedules filename update every X hours for all media files using background processing.

Restrict file renaming by user role

Choose what type of user roles will be allowed to rename files.

Restrict file renaming by post type

The renaming will only work for media attached to the selected post types.

Compatibility with 3rd party plugins


Does not rename when uploading profile pictures.

Gravity forms

Handles issues with Gravity Forms entry exports.


Fixes WPForms upload.

Admin settings

General section

Rules section

Advanced section