Table of Contents
Advanced troubleshooting #
When Rename Media Files: Improve Your WordPress SEO renames inconsistently after the basic checks, look for a PHP error in the WordPress debug.log and server error logs around the upload time. Then start with a simple filename structure, add tokens and rules one at a time, test with an upload after each change, and back up first.
Symptom #
Renaming behaves inconsistently and the earlier troubleshooting steps did not surface the cause.
Cause #
Deeper issues are usually environment specific: a PHP error during the upload, an overly complex set of rules, or a change made without a fallback to revert to.
Fix steps #
- Check your error logs. Review the WordPress
debug.logand your server error logs for any entries logged around the time of the upload. - Start simple. Begin with a basic filename structure, confirm it works, then add tokens and rules one at a time so any conflict is easy to spot.
- Test thoroughly. After each settings change, upload a test file and confirm the result before relying on it for real content.
- Back up your site. Always take a full backup before making significant changes or running bulk operations, so you can roll back if needed.
Need a hand? Our team answers every ticket on the Rename Media Files support forum.
