{"id":2987,"date":"2026-10-06T17:40:24","date_gmt":"2026-10-06T17:40:24","guid":{"rendered":"https:\/\/kb.shortpixel.com\/?post_type=docs&#038;p=2987"},"modified":"2026-10-08T13:46:47","modified_gmt":"2026-10-08T13:46:47","password":"","slug":"how-to-rename-images-with-shortpixel-image-optimizer","status":"publish","type":"docs","link":"https:\/\/kb.shortpixel.com\/knowledge-base\/article\/how-to-rename-images-with-shortpixel-image-optimizer\/","title":{"rendered":"How to rename images with ShortPixel Image Optimizer or AI Alt Text Generator"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">ShortPixel Image Optimizer can give an image file a new name, for example turning <code>IMG_4031.jpg<\/code> into <code>red-summer-dress.jpg<\/code>, and it updates every place on your own website that shows that image. The one thing to know before you do it: <strong>the image&#8217;s web address changes and the old address stops working.<\/strong> Your own site keeps working, but links to the image from other websites, and the image in Google Images, will break until they are updated.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What does renaming an image mean?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Every image on your website is a file with a name, like <code>IMG_4031.jpg<\/code>. That name is also part of the image&#8217;s web address (its URL), for example <code>https:\/\/yoursite.com\/wp-content\/uploads\/2026\/10\/IMG_4031.jpg<\/code>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Renaming changes that name, and so it changes the web address too. The picture itself stays exactly the same.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Why would you want to?<\/strong> Search engines read file names to understand what an image shows. A descriptive name like <code>red-summer-dress.jpg<\/code> tells Google much more than <code>IMG_4031.jpg<\/code>, which can help your images appear in image searches. Clear names also make your Media Library easier to search.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You can rename images yourself, one by one (this article), or let ShortPixel&#8217;s AI suggest a descriptive name automatically. The AI option is <strong>Update image filename with an SEO-friendly one<\/strong> under Settings > ShortPixel > AI Image SEO or under Settings > ShortPixel AI Alt Text Generator > AI Image SEO if you&#8217;re using the ShortPixel AI Alt Text Generator plugin. Everything below applies to both.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">How to rename an image, step by step<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>In your WordPress dashboard, go to <strong>Media &gt; Library<\/strong>.<\/li>\n\n\n\n<li>Click the image you want to rename, then click <strong>Edit more details<\/strong> (or, in list view, click the image&#8217;s name). This opens the image&#8217;s own edit page.<\/li>\n\n\n\n<li>On the right, in the box with the <strong>Update<\/strong> button, find the <strong>Filename<\/strong> field. It shows the current name, for example <code>IMG_4031.jpg<\/code>.<\/li>\n\n\n\n<li>Type the new name, for example <code>red-summer-dress<\/code>. Use a few words that describe the picture, separated by dashes. You don&#8217;t need to type <code>.jpg<\/code>; the file type never changes.<\/li>\n\n\n\n<li>Read the warning under the field: hover over the area for a short explanation, or click the ? to open this article. In short, links from other websites will stop working (more on this below).<\/li>\n\n\n\n<li>Click <strong>Rename file<\/strong>.<\/li>\n\n\n\n<li>The page reloads and shows the new name. That&#8217;s it.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Don&#8217;t see the Filename field?<\/strong> It is part of the AI Image SEO tools, so it only appears when <strong>Enable AI Image SEO<\/strong> is switched on (Settings > ShortPixel > AI Image SEO). It is on by default. It is also hidden for images stored only on a cloud service ShortPixel cannot rename files on. (WP Offload Media is supported.) If you&#8217;re using the ShortPixel AI Alt Text Generator plugin, please make sure that the &#8220;Update image filename with an SEO-friendly one option&#8221; is enabled.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Good names, in short:<\/strong> lowercase, words separated by dashes, describe what is in the picture, keep it short. ShortPixel automatically removes spaces and special characters, and a name needs at least 3 characters.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What ShortPixel updates for you<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">When you rename an image, ShortPixel takes care of everything on <strong>your own website<\/strong>, so nothing breaks there:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>The image and all its sizes.<\/strong> WordPress keeps several sizes of each image (thumbnail, medium, large and so on). All of them get the new name.<\/li>\n\n\n\n<li><strong>The WebP and AVIF versions<\/strong> that ShortPixel created, so faster formats keep being delivered.<\/li>\n\n\n\n<li><strong>Your backups.<\/strong> The original copies ShortPixel keeps are renamed too, so <strong>Restore<\/strong> still works afterwards.<\/li>\n\n\n\n<li><strong>Every link on your site.<\/strong> Posts, pages, and content saved by page builders and other plugins are updated to the new address automatically.<\/li>\n\n\n\n<li><strong>The image&#8217;s details in WordPress<\/strong>, so the Media Library shows the new name. The image&#8217;s title, alt text, caption and description are not changed.<\/li>\n\n\n\n<li><strong>Translations.<\/strong> If you use WPML or Polylang, every language version of the image follows the new name.<\/li>\n\n\n\n<li><strong>Cloud storage.<\/strong> If your images are offloaded with WP Offload Media, the copies in your cloud storage are renamed as well.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">What renaming cannot fix: links outside your website<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">ShortPixel can only update what is stored on your own website. It <strong>does not create a redirect<\/strong> from the old address to the new one. A redirect is a forwarding rule, like a forwarding address when you move house. Without one, anyone who visits the old address gets a \u201cpage not found\u201d (404) error instead of the image.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">That affects places ShortPixel cannot reach:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Other websites<\/strong> that link to your image or show it on their pages.<\/li>\n\n\n\n<li><strong>Google Images and other search engines.<\/strong> If Google has already listed your image, its search result points to the old address until Google visits your site again and finds the new one. That can take days or weeks, and the image may lose its position in the results for a while.<\/li>\n\n\n\n<li><strong>Social media posts, newsletters and emails<\/strong> where you shared the image&#8217;s address.<\/li>\n\n\n\n<li><strong>Bookmarks and saved links<\/strong> your visitors may have.<\/li>\n\n\n\n<li><strong>Caches.<\/strong> A caching plugin or a CDN may keep showing the old version of a page for a while. Clear your cache after renaming.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>If an image is important and already well known<\/strong>, you can keep the old address working by adding a redirect yourself, for example with a free redirection plugin. Point the old image address to the new one.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">When to rename, and when to leave a name alone<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><th>Situation<\/th><th>Our advice<\/th><\/tr><tr><td>You just uploaded the image and haven&#8217;t published it yet<\/td><td><strong>Rename freely.<\/strong> Nobody outside your site knows the old address.<\/td><\/tr><tr><td>The image is new and only used on your own pages<\/td><td><strong>Rename.<\/strong> Your pages are updated automatically.<\/td><\/tr><tr><td>The image has been online for a long time and gets visitors from Google Images<\/td><td><strong>Think twice.<\/strong> Add a redirect if you rename it, or keep the current name.<\/td><\/tr><tr><td>Other websites link to the image, or you shared it on social media or in a newsletter<\/td><td><strong>Keep the name<\/strong>, or add a redirect from the old address.<\/td><\/tr><tr><td>The current name already describes the image well<\/td><td><strong>Leave it.<\/strong> There is little to gain.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Before you rename:<\/strong> save and close any post or page you are editing that uses this image, so an open editor doesn&#8217;t save the old address back.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>ShortPixel Image Optimizer can give an image file a new name, for example turning IMG_4031.jpg into red-summer-dress.jpg, and it updates every place on your own website that shows that image. The one thing to know before you do it: the image&#8217;s web address changes and the old address stops working. Your own site keeps working, [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[37,59],"glossaries":[],"doc_tag":[],"class_list":["post-2987","docs","type-docs","status-publish","hentry","doc_category-shortpixel-image-optimizer","doc_category-wordpress-plugins"],"blocksy_meta":[],"year_month":"2026-10","word_count":1026,"total_views":"10","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"admin","author_nicename":"admin_mdli53m5","author_url":"https:\/\/kb.shortpixel.com\/author\/admin_mdli53m5\/"},"doc_category_info":[{"term_name":"ShortPixel Image Optimizer","term_url":"https:\/\/kb.shortpixel.com\/knowledge-base\/category\/shortpixel-image-optimizer\/"},{"term_name":"WordPress Plugins","term_url":"https:\/\/kb.shortpixel.com\/knowledge-base\/category\/wordpress-plugins\/"}],"doc_tag_info":[],"knowledge_base_info":[],"knowledge_base_slug":[],"_links":{"self":[{"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/docs\/2987","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/comments?post=2987"}],"version-history":[{"count":3,"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/docs\/2987\/revisions"}],"predecessor-version":[{"id":2992,"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/docs\/2987\/revisions\/2992"}],"wp:attachment":[{"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/media?parent=2987"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/doc_category?post=2987"},{"taxonomy":"glossaries","embeddable":true,"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/glossaries?post=2987"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/doc_tag?post=2987"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}