{"id":87365,"date":"2022-04-24T10:54:00","date_gmt":"2022-04-24T15:54:00","guid":{"rendered":"https:\/\/wpengine.com\/?post_type=resource&#038;p=87365"},"modified":"2026-01-26T02:52:14","modified_gmt":"2026-01-26T08:52:14","slug":"wordpress-image-alt-text","status":"publish","type":"resource","link":"https:\/\/wpengine.com\/case-studies\/resources\/wordpress-image-alt-text\/","title":{"rendered":"WordPress Image Alt Text"},"content":{"rendered":"\n<p>Search engines are pretty good when it comes to figuring out <a href=\"https:\/\/element502.com\/how-do-search-engines-determine-relevance-and-popularity\/\" target=\"_blank\" rel=\"noreferrer noopener\">what your content is about<\/a> and when it&#8217;s relevant for the reader. To achieve this, they rely on indicators such as keywords, subheadings, and alt text.<\/p>\n\n\n\n<p>For every image you add to your website, you should also include descriptive alt text alongside it. This will show up in case your image isn\u2019t able to load for whatever reason, and it tells both users and search engines about what it represents.<\/p>\n\n\n\n<p>In this article, we&#8217;ll talk a bit more about <a href=\"https:\/\/moz.com\/learn\/seo\/alt-text\" target=\"_blank\" rel=\"noreferrer noopener\">what alt text is<\/a>, how it impacts Search Engine Optimization (SEO), and how to add it to your images. Let&#8217;s get to it!<\/p>\n\n\n\n\n\n<h2 class=\"wp-block-heading\">What Is Image Alt Text?<\/h2>\n\n\n\n<p>Alternative text, alt text, alt description, alt pictures, or alt tags all refer to the same thing. Basically, they\u2019re a human-readable description you add to your website\u2019s images in case the file can\u2019t load. <\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-medium\"><img loading=\"lazy\" decoding=\"async\" width=\"540\" height=\"360\" src=\"https:\/\/wpengine.com\/wp-content\/uploads\/2024\/01\/shutterstock_1783891112-540x360.jpg\" alt=\"A rose garden\" class=\"wp-image-148929\" srcset=\"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2024\/01\/shutterstock_1783891112-540x360.jpg 540w, https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2024\/01\/shutterstock_1783891112-1024x683.jpg 1024w, https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2024\/01\/shutterstock_1783891112-768x512.jpg 768w, https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2024\/01\/shutterstock_1783891112-1536x1024.jpg 1536w, https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2024\/01\/shutterstock_1783891112-2048x1366.jpg 2048w, https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2024\/01\/shutterstock_1783891112-1500x1000.jpg 1500w\" sizes=\"auto, (max-width: 540px) 100vw, 540px\" \/><\/figure>\n\n\n\n<p>For example, take the image above with the alt text of \u201cA rose garden,\u201d which you can check out if you inspect the element. However, the text itself won\u2019t usually be evident when you\u2019re browsing a website unless something goes wrong. There are two reasons why alt text is important:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Accessibility:<\/strong> With descriptive alt-text, visually impaired visitors will still know what each image represents using a screen reader.<\/li>\n\n\n\n<li><strong>SEO:<\/strong> Alt tags give search engines an idea of what your images represent, so they can better categorize your content.<\/li>\n<\/ol>\n\n\n\n<p>Overall, there&#8217;s no reason why you shouldn&#8217;t include alt text in your pages. The more descriptive the text is, the greater the benefits since it provides more information to both users and search engines.<\/p>\n\n\n\n<p>In addition, the process of adding alt text is simple. If you&#8217;re using plain HTML (or working with the WordPress code editor), an alt tag will take the following format:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;img src=\"pancakes.png\" alt=\"A stack of pancakes\"&gt;<\/code><\/pre>\n\n\n\n<p>However, the whole thing is even more straightforward when using the WordPress back end and <em>Media Library<\/em>, since you don&#8217;t have to tinker with HTML to add alt tags.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">How to Add Alt Text to an Image in WordPress<\/h2>\n\n\n\n<p>Whenever you upload an image to WordPress, you&#8217;ll be able to edit its metadata, which will give you access to the following menu.<\/p>\n\n\n\n<p>On the right-hand side are the fields you\u2019ll want to fill in. For example, you can change your image title, caption, overall description, and alt text.<\/p>\n\n\n\n<p>While there are many different permutations of alt text, something adequate for this image could be \u201cA very angry cat.\u201d Simply type in an accurate description within the corresponding field, save your changes, and you&#8217;re good to go. You can also go back and edit alt text whenever it&#8217;s necessary.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"302\" height=\"377\" src=\"https:\/\/wpengine.com\/wp-content\/uploads\/2024\/01\/alt-text.png\" alt=\"a selected image within a WordPress website's media library that shows where a user should enter alt text\" class=\"wp-image-148928\"\/><\/figure>\n\n\n\n<p>If you&#8217;re wondering about the difference between alt text and the caption, the latter displays on the front end as a description for readers, whereas the former is not supposed to be displayed at the same time as your image.<\/p>\n\n\n\n<p>As for the image <em>Description <\/em>field, this contains information that will show up if someone accesses an image URL directly. It&#8217;s not the same as the <em>Alt Text <\/em>tag though, and in most cases, you can get away with not adding anything to the <em>Description <\/em>field.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Image Alt Text Best Practices<\/h2>\n\n\n\n<p>In a nutshell, writing good alt text boils down to one element \u2013 being descriptive without becoming overly long. Take the following image as an example.<\/p>\n\n\n\n<p>Ideally, your alt text should fall below the 125 character mark to comply with the greatest number of screen readers. For this image, you could use text such as \u201cA cheeseburger with salad, in front of a backdrop of fire.\u201d It&#8217;s descriptive enough and it gets right to the point, which makes it perfect.<\/p>\n\n\n\n<p>Alt text also provides you with a perfect opportunity to include your post keywords, and is a metric within WordPress plugins such as <a href=\"https:\/\/wordpress.org\/plugins\/wordpress-seo\/\" target=\"_blank\" rel=\"noreferrer noopener\">Yoast SEO<\/a>. However, be mindful here as <a href=\"https:\/\/searchenginewatch.com\/2018\/07\/13\/keyword-stuffing-is-terrible-for-your-seo-heres-what-to-do-instead\/\" target=\"_blank\" rel=\"noreferrer noopener\">keyword stuffing<\/a>\u2014even in alt text\u2014is a big red flag to search engines. It pays to be descriptive primarily, regardless of SEO concerns.<\/p>\n\n\n\n<p>Finally, some people make the mistake of including text such as \u201cA screenshot of\u2026\u201d or \u201cA picture of\u2026\u201d within their alt tags. This is superfluous, as search engines and screen readers already know they&#8217;re dealing with pictures, so the description is all that\u2019s necessary.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Solving the &#8220;Image alt attributes are missing&#8221; Error in Yoast SEO<\/h2>\n\n\n\n<p>We\u2019ve already briefly mentioned the Yoast SEO plugin in the previous section. It provides you with suggestions and functionality you can use to make sure your website&#8217;s SEO is top-notch. One metric is to remind you to include alt text for your images.<\/p>\n\n\n\n<p>In other words, when Yoast detects missing alt text for multiple images, it&#8217;ll remind you to add them. You\u2019ll still be able to publish your post or page, but you&#8217;ll lose out on all the benefits we&#8217;ve discussed so far on alt tags.<\/p>\n\n\n\n<p>If you didn\u2019t add alt text from the Media Library, you can do so from within WordPress\u2019 Block Editor. Simply select the relevant image and a menu will appear to the right.<\/p>\n\n\n\n<p>Here, you can add or edit your image&#8217;s alt text in a similar fashion to the <em>Media Library<\/em>. This would need to be carried out for every image you upload. It&#8217;ll soon become second nature, and you&#8217;ll never forget to add alt text again.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Learn More With WP Engine<\/h3>\n\n\n\n<p>There are a lot of boxes to tick when it comes to carrying out best SEO practices, including image SEO. However, for this effort to pay off, you also want to offer users a great experience when visiting your website. This means providing a wealth of features, digital accessibility, and excellent performance.<\/p>\n\n\n\n<p>With WordPress, you\u2019re given a lot of guidance to help you <a href=\"https:\/\/developer.wordpress.org\/\" target=\"_blank\" rel=\"noreferrer noopener\">implement any desired functionality<\/a> on your website. What\u2019s more, with a solid and <a href=\"https:\/\/wpengine.com\/plans\/\" target=\"_blank\" rel=\"noreferrer noopener\">cost-effective host<\/a> such as WP Engine at your back, your site will benefit from <a href=\"https:\/\/wpengine.com\/wordpress-hosting\/\" target=\"_blank\" rel=\"noreferrer noopener\">hosting that is optimized specifically for WordPress sites<\/a>, including an optimized and stable server to provide you with the best possible performance!<br><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Search engines are pretty good when it comes to figuring out what your content is about and when it&#8217;s relevant for the reader. To achieve this, they rely on indicators such as keywords, subheadings, and alt text. For every image you add to your website, you should also include descriptive alt text alongside it. This<span class=\"tile__ellipses\">&hellip;<\/span><span class=\"tile__ellipses--animated\"><\/span><\/p>\n","protected":false},"author":297,"featured_media":148926,"template":"","resource-topic":[910],"resource-role":[895,906,897,903,1296],"resource-type":[916],"class_list":["post-87365","resource","type-resource","status-publish","has-post-thumbnail","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v20.9 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>How To Add Alt Tags to Images in WordPress<\/title>\n<meta name=\"description\" content=\"Adding image alt text or alt tags improves site accessibility and SEO. Check out our easy step-by-step guide to add alt text to images in your media library.\" \/>\n<meta name=\"robots\" content=\"noindex, follow\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How To Add Alt Tags to Images in WordPress\" \/>\n<meta property=\"og:description\" content=\"Adding image alt text or alt tags improves site accessibility and SEO. Check out our easy step-by-step guide to add alt text to images in your media library.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/wpengine.com\/case-studies\/resources\/wordpress-image-alt-text\/\" \/>\n<meta property=\"og:site_name\" content=\"WP Engine\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/wpengine\" \/>\n<meta property=\"article:modified_time\" content=\"2026-01-26T08:52:14+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2022\/04\/alt-text-header.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1100\" \/>\n\t<meta property=\"og:image:height\" content=\"500\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:title\" content=\"How To Add Alt Tags to Images in WordPress\" \/>\n<meta name=\"twitter:description\" content=\"Adding image alt text or alt tags improves site accessibility and SEO. Check out our easy step-by-step guide to add alt text to images in your media library.\" \/>\n<meta name=\"twitter:image\" content=\"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2022\/04\/alt-text-header.png\" \/>\n<meta name=\"twitter:site\" content=\"@wpengine\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/wpengine.com\/case-studies\/resources\/wordpress-image-alt-text\/\",\"url\":\"https:\/\/wpengine.com\/case-studies\/resources\/wordpress-image-alt-text\/\",\"name\":\"How To Add Alt Tags to Images in WordPress\",\"isPartOf\":{\"@id\":\"https:\/\/wpengine.com\/case-studies\/#website\"},\"datePublished\":\"2022-04-24T15:54:00+00:00\",\"dateModified\":\"2026-01-26T08:52:14+00:00\",\"description\":\"Adding image alt text or alt tags improves site accessibility and SEO. Check out our easy step-by-step guide to add alt text to images in your media library.\",\"breadcrumb\":{\"@id\":\"https:\/\/wpengine.com\/case-studies\/resources\/wordpress-image-alt-text\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/wpengine.com\/case-studies\/resources\/wordpress-image-alt-text\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/wpengine.com\/case-studies\/resources\/wordpress-image-alt-text\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/wpengine.com\/case-studies\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Resources\",\"item\":\"https:\/\/wpengine.com\/case-studies\/resources\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"WordPress Image Alt Text\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/wpengine.com\/case-studies\/#website\",\"url\":\"https:\/\/wpengine.com\/case-studies\/\",\"name\":\"WP Engine\",\"description\":\"Managed Hosting for WordPress\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/wpengine.com\/case-studies\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/wpengine.com\/case-studies\/#\/schema\/person\/3a22232b01de39dcf588fb8e421c0521\",\"name\":\"Erin Myers\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/wpengine.com\/case-studies\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/cd881e115bc28c81642ec61752db9981ece9ee8b4c81498a9b6276b9cdcaf5e6?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/cd881e115bc28c81642ec61752db9981ece9ee8b4c81498a9b6276b9cdcaf5e6?s=96&d=mm&r=g\",\"caption\":\"Erin Myers\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"How To Add Alt Tags to Images in WordPress","description":"Adding image alt text or alt tags improves site accessibility and SEO. Check out our easy step-by-step guide to add alt text to images in your media library.","robots":{"index":"noindex","follow":"follow"},"og_locale":"en_US","og_type":"article","og_title":"How To Add Alt Tags to Images in WordPress","og_description":"Adding image alt text or alt tags improves site accessibility and SEO. Check out our easy step-by-step guide to add alt text to images in your media library.","og_url":"https:\/\/wpengine.com\/case-studies\/resources\/wordpress-image-alt-text\/","og_site_name":"WP Engine","article_publisher":"https:\/\/www.facebook.com\/wpengine","article_modified_time":"2026-01-26T08:52:14+00:00","og_image":[{"width":1100,"height":500,"url":"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2022\/04\/alt-text-header.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_title":"How To Add Alt Tags to Images in WordPress","twitter_description":"Adding image alt text or alt tags improves site accessibility and SEO. Check out our easy step-by-step guide to add alt text to images in your media library.","twitter_image":"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2022\/04\/alt-text-header.png","twitter_site":"@wpengine","twitter_misc":{"Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/wpengine.com\/case-studies\/resources\/wordpress-image-alt-text\/","url":"https:\/\/wpengine.com\/case-studies\/resources\/wordpress-image-alt-text\/","name":"How To Add Alt Tags to Images in WordPress","isPartOf":{"@id":"https:\/\/wpengine.com\/case-studies\/#website"},"datePublished":"2022-04-24T15:54:00+00:00","dateModified":"2026-01-26T08:52:14+00:00","description":"Adding image alt text or alt tags improves site accessibility and SEO. Check out our easy step-by-step guide to add alt text to images in your media library.","breadcrumb":{"@id":"https:\/\/wpengine.com\/case-studies\/resources\/wordpress-image-alt-text\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/wpengine.com\/case-studies\/resources\/wordpress-image-alt-text\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/wpengine.com\/case-studies\/resources\/wordpress-image-alt-text\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/wpengine.com\/case-studies\/"},{"@type":"ListItem","position":2,"name":"Resources","item":"https:\/\/wpengine.com\/case-studies\/resources\/"},{"@type":"ListItem","position":3,"name":"WordPress Image Alt Text"}]},{"@type":"WebSite","@id":"https:\/\/wpengine.com\/case-studies\/#website","url":"https:\/\/wpengine.com\/case-studies\/","name":"WP Engine","description":"Managed Hosting for WordPress","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/wpengine.com\/case-studies\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/wpengine.com\/case-studies\/#\/schema\/person\/3a22232b01de39dcf588fb8e421c0521","name":"Erin Myers","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/wpengine.com\/case-studies\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/cd881e115bc28c81642ec61752db9981ece9ee8b4c81498a9b6276b9cdcaf5e6?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/cd881e115bc28c81642ec61752db9981ece9ee8b4c81498a9b6276b9cdcaf5e6?s=96&d=mm&r=g","caption":"Erin Myers"}}]}},"acf":[],"grid_image_url":"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2022\/04\/alt-text-grid.png","media-type":{"term_id":916,"name":"Article","slug":"article"},"role":"<strong>Roles:<\/strong> Agency, Entrepreneur, Freelancer, Marketer, Publisher","topic":"<strong>Topics:<\/strong> SEO","_links":{"self":[{"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/resource\/87365","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/resource"}],"about":[{"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/types\/resource"}],"author":[{"embeddable":true,"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/users\/297"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/media\/148926"}],"wp:attachment":[{"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/media?parent=87365"}],"wp:term":[{"taxonomy":"resource-topic","embeddable":true,"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/resource-topic?post=87365"},{"taxonomy":"resource-role","embeddable":true,"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/resource-role?post=87365"},{"taxonomy":"resource-type","embeddable":true,"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/resource-type?post=87365"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}