Fixing Alt Tags Not Showing In WordPress In 2 Easy Steps

fixing alt attribute not showing in wordpress featured image

Have you ever wondered why, despite adding alt attributes to your images in WordPress, they still don’t appear? This is a frequent issue, but fortunately, we have discovered a simple solution. There are two common explanations for why the alt text may not be visible in your code, even if you’re certain that you have included it on the page.

If you’re unable to see alt tags in your HTML code, re-insert the image onto the page and empty your website’s cache. WordPress cannot add the new alt tag, and you need to overwrite the existing empty one manually. After that, clean your site cache to ensure you see the freshest content.

Alt attribute not working in WordPress

As we know, alt text is an important part of your image SEO and giving context to the images on your page as Google still needs the alt text among other things to know what is shown on an image on your page.

So, as you are here you are probably experiencing that you can’t get your alt tags to show using WordPress. Normally, we found out that this is caused by one of two things which I will explain in detail and guide you to fix the alt tags that don’t show.

Often you would have found out that there is a problem with alt tags using an SEO tool showing you if your website missing alt tags. But when checking your media library you see the alt tags right there. The problem here is, that any crawler – even Google’s – doesn’t really care about your media library as they can’t access it.

Web crawlers are looking at your page code and therefore you need to search and find the image in the source code and check if there is an alt attribute – or search for: alt=””

If the field between “” is empty, that means there is no alt tag present in the code even though you added it through your Media Library. So, what to do now?

Now we’ll look at how exactly these two errors manifest themselves.

Step 1. Fix Overwritten Alternative Text

The issue of overwriting is commonly observed on pages or posts where an image is inserted before adding the alt text. In such cases, WordPress occasionally inserts an empty alt text that needs to be overwritten manually.

When inserting new images, WordPress has the capability to retrieve the image alt tag from the Media Library. Nevertheless, if you have already inserted an image into a blog post, examining the “Text” editor will uncover an empty alt text present.

Once inserted, the image without a specified alt text might get a blank “alt” attribute in the code of your page. The same could happen if you’re updating your alt tags in the Media LibraryWordPress won’t update the actual alt tag in the page’s code until you re-insert the page’s image if you decide to change them later. To get that rolling, simply:

  1. Re-insert the image on the page – so that the HTML code part updates automatically and adds your alt tag.
  2. Or copy-paste the alt text from your Media Library to the Image Detail editor on the specific image.
  3. Or copy-paste the alt tag from your Media Library to the HTML code (in the “Text” editor) on your page.

Unfortunately, you have to do this manually in all three scenarios – but the first one is at least for me much quicker to do. Also, consider that you’re editing the HTML of a potentially important page. Both the first and second methods save you from potentially deleting images from important pages and thus breaking them.

fixing alt tags not showing step 1 reinsert the image or alt tag

All of this means that finding alt tags for all images can be a daunting task, especially for large websites with many pictures on each page. Because I face the same challenge, I’ve figured it’s best to use a Site Audit checker. A simple tool like this gives you the full list of all images that are missing their alt tags.

check if all alt tags are working with an seo tool

From there, making a to-fix list is much easier and allows you to do all of them in, say, one slow afternoon.

Step 2. See Alt Tags By Clearing Cache

Whenever you implement WordPress changes, it’s best to clear your cache so that you’re sure the changes are applied. Most modern WordPress sites have several layers of caching running at the same time. That is great and more or less critical for good website performance. However, it can sometimes cause the annoying issue of not updating a page’s contents even after you’ve saved your changes.

Here, all you have to do is clear the cache on your website and your local machine (i.e., your computer).

To clear the cache from your website:

  1. Navigate to your Caching plugin of choice.
  2. Click “Clear Cache.”

Your caching plugin is also usually displayed in the top navigational bar of your WordPress dashboard.

clearing cache to see changes with images

If you happen to be using an extra layer of caching through a Content Delivery Network (CDN), it’s best you clear that, too. The most widespread CDN is Cloudflare, so much so that it comes together with some hosting plans (e.g., BlueHost offers it by default). Log into your Cloudflare account and clear the Cache, as shown below.

fixing alt tags not showing step 2 clearing cache cloudflare example


If you don’t remember creating a Cloudflare account, you will likely find the setup for that in the Dashboard provided to you by your website hosting company.

To Clear Cache From Your Computer:

And now, onto the step of clearing the cache stored on your computer, assuming you’re using Google Chrome:

  • On Windows, press CTRL + F5.
  • On Mac, press CMD + SHIFT + R

For those of you using Firefox, the shortcuts are:

  • Once again, on Windows, simply press CTRL + F5.
  • Similarly, on Mac, press CMD + SHIFT + R.

Lastly, Safari is also a popular browser, and the shortcut key combination there is:

  • On Mac, click CMD + ALT + E.

If you’re using a different browser, simply search for “how to clear browser cache in [your browser here]” on Google.

In all instances, you’re simply going to see the website refresh and potentially take a couple more seconds to load. After that, you’re good to go!

Closing Off

That’s it for now, folks! I’ve seen dozens of websites experiencing that issue, and in all instances, simply following the steps above solved the issue. If you’re still having trouble, the reason can be much deeper with how your website is made. In that case, I strongly recommend getting in touch with your hosting provider, who can often help you correct big mistakes like that.

If you are using Morningscore and you see the tool report missing alt tags but you can confirm that there is an alt tag in the source code for that exact image, please try to “scan” the problem. If it doesn’t get resolved, feel free to reach out to us in the chat in the bottom right corner.

Check our list of the most simple SEO tools for beginners to monitor missing alt-tags.

Take care!

5 out of 5 stars

“Morningscore provides a simple overview of competitors, and most importantly, makes working with SEO fun! The "Mission" tool is a favorite, but the "Health" section is also a useful feature that easily explains what adjustments and corrections need to be made on my website.”

Bjorn Marius Narjord, an Independent SEO Consultant from Intent SEO

Bjørn Marius Narjord

Owner and SEO-specialist, Intent SEO
5 out of 5 stars

“Morningscore is the easiest SEO tool I've ever seen and used – and I've tested so many of them. The charts and data may be comparable to those of competitors, but the fun part comes in when you make use of the many ways to play 'catch me if you can' with a competitor.”

rasmus schuebel kreativling morningscore review

Rasmus Schübel

Owner & Founder, kreativling
5 out of 5 stars

“A truly usable and effective SEO tool without many disruptive elements. This means that I can actually use the tool for something specific that gives our business value.”

heidi kirstein seo tool review

Heidi Kerstein

Marketing coordinator, Fitness Engros A/S
5 out of 5 stars

“Morningscore gives me that vital view of our rankings on search engines, and I can see up-to-date information on how we're performing against our competitors and whether we're gaining or losing traction. I also find the tool very easy to use. It just works.”

patrick qureshi

Patrick Qureshi

5 out of 5 stars

“I’ve used Morningscore since the beginning of my company. I tried many tools, but my heart fell for Morningscore because it’s so easy to use - and because I work with many small businesses who MUST have the tool for me to help them.”

christina lund schmeltz

Christina Schmeltz

Owner, LS Marketing
5 out of 5 stars

“I use Morningscore because SEO is not my specialty, and I don’t want to spend time on it. I have an internal team who takes care of SEO, but I need to know the outcome of their work. With this tool, I can log in and see our performance from day to day.”

esben oesterby

Esben Østerby

Founder, Iværksætterhistorier
5 out of 5 stars

“I was looking for a tool to help my customers see exactly what we’re working on and what value it gives them. I’ve found that with Morningscore. I recommend the platform to anyone who needs to manage and improve their SEO.”

Trolle Hansen trolle reklame

Trolle Hansen

Owner, Trolle Reklame
5 out of 5 stars

“Three years ago I chose Morningscore because I was new to SEO and it was the easiest SEO tool to use. I'm still using Morningscore because it is regularly updated and becomes more powerful with every release. It's fun to use. Morningscore is such an integral part of my day. I check it before I check my email.”

sven recommends Morningscore's SEO tool

Sven Radavics