hello@ayzmancreative.com

Journal

What Cleveland website developers miss when renaming images

Renaming image files so they describe what’s in them is a small SEO job that a lot of business owners ask for. It’s also one that Cleveland website developers regularly get wrong, because the filename lives in more places than the media library.

Why it’s more than a rename

When you upload an image to WordPress, its filename gets written into the site wherever that image is used. Change the file and every one of those references still points at the old name. Some break loudly with an empty box where the photo was. Others break quietly, and those are the ones that cause trouble weeks later.

When we renamed the product images on a label and packaging printer’s site, these are the places we had to update:

  • The post and service content itself, where the image is placed directly.
  • Builder shortcodes, which often point at an image ID or a stored URL instead of the file you see in the editor.
  • Social sharing images, the ones that show up when someone posts your link on Facebook or LinkedIn.
  • CSS rules that select an image by its filename.

The one people miss

The CSS rules are the ones that get skipped. A developer might have written a style that targets one specific image by its filename, to crop it, add a border or hide it on phones. Rename the file and that rule stops matching anything. Nothing throws an error. The image just shows up at the wrong size or in the wrong spot, and nobody connects it to the rename because it happened weeks earlier. Search your theme’s stylesheet and any custom CSS for the old filenames before you call the job done.

Keep the old files

Google indexes image URLs, and some of your images may already show up in image search or get linked from other sites. If you delete the original files after renaming, those URLs start returning 404s. We leave the old files in place so anything pointing at them keeps working, and let the new names take over from there.

A good rename also comes with new alt text written for a person who can’t see the image, which does more for accessibility and search than the filename does on its own. Describe what’s actually in the photo in plain words.

If you’re working with Cleveland website developers on image SEO, ask them how they’ll find every reference to the old names before they start, and whether they plan to keep the originals. That one question tells you a lot about how careful the rest of the work will be. It’s how we handle it on WordPress websites we build and maintain in Cleveland and on custom development projects.

If you’ve already renamed images and something looks off, send us a link to your site. We’ll track down the broken references and tell you what needs fixing.

Privacy Settings
We use cookies to enhance your experience while using our website. If you are using our Services via a browser you can restrict, block or remove cookies through your web browser settings. We also use content and scripts from third parties that may use tracking technologies. You can selectively provide your consent below to allow such third party embeds. For complete information about the cookies we use, data we collect and how we process them, please check our Privacy Policy