New Feature - Add Alt Text to Featured Images

Hi, It would be useful to have the ability to easily add alt text to blog 'featured images'. At the moment there is no field to add alt text to featured images and the workarounds Hubspot suggests aren't optimal. For example: 1) This fix will only pull through the title / name of the article (rather than specially written alt text) and does not display the alt text when you hover over the image. 2) Removing the featured image and replacing it with an image at the top of the 'body' text does enable you to add alt text, however, the image disappears from the blog 'listing page' making it much less aesthetic / clean. I would think this is quite a common issue for those trying to optimise alt text on their sites so hopefully if enough people have this problem, a fix / new feature can be implemented. Thanks, John

18 Replies

I have 56 pages with missing alt tags on images - each with mulitple featured images (from 1-17) and it makes it difficult to find other issues when trying to clean up our SEO.


Because many HubSpot partners use the blog engine to create content libraries for clients, the featured image is not just showing up on blog listing pages where posts are pulled through, but actually hurting content pages because those featured images do not have an alt tag.


It seems simple enough to add a "Featured Image Alt Text" box below the featured image in the settings dialog.

New Contributor

Agreed. It would be easier to have that feature as part of the UI.


If you get to funky on customizing the posts or listings templates, you can run into these "ALT tag" issues.


Currently, we are using a pretty simple custom module for this. On "posts" pages, we call the Featured Image and have custom module to additionally call any ALT tag we choose -- not just the blog title. The module UI shows on any Posts edit page:


Here's the module:


{% if content.post_list_summary_featured_image %}
        <div class="hs-featured-image-wrapper">
            <a href="{{content.absolute_url}}" title="" class="hs-featured-image-link">
                <img src="{{ content.post_list_summary_featured_image }}" alt="{{ widget.contentfeatured_image_alt_text }}" class="hs-featured-image">
{% endif %}



Widget field:

{{ widget.contentfeatured_image_alt_text }}





Thanks @JohnPate - because of the way ours are setup, it would be lot of work to rework the COS pages to have the widget ILO the HubL code they were setup with.


I'm still finding this to be an issue with our site audits, we have numerous pages that pull 'posts' into 'listing' pages - on the posts, all the images have alt tags, but the featured image being pulled through to the listing page isn't pulling the alt tag.


I'm digging into the code to see if there is a similar solution, but think this really needs to be a UI improvement.

New Contributor

A similar feature was recently added to CTA images, so I'd like to think an option for adding alt text to featured images is coming soon. If not, it should be. I never thought I'd say Wordpress is better than HubSpot, but in this case, WordPress makes adding alt text to just about any image super simple—without the need for any special code or custom modules. 

Occasional Contributor | Platinum Partner

Agreed! This would be great to have. I have just convert the blog tool to the beta version of Hubspot's new blog tool. Not sure if they have fix it in the new version?

New Contributor

Google places a relatively high value on alt text to determine not only what is on the image but also the topic of the surrounding text, hence SEO optimization.


Just include a checkbox, customized alt text? When checked, show input field for users to type in the desired alt text.

Occasional Contributor

Completely agree! 

I love Hubspot but some of the gaps that have been left out of the user experience have me just completely baffled.

Regular Contributor | Platinum Partner

Yeah, this should definitely be a feature. And to be honest, the fact it was never added when they originally developed their "CMS" is mind boggling. Every CMS I've ever worked in allows you to set the alt text when uploading the image to the media library/files section (wherever the images live) or as you're adding it to the page. You can easily add alt text to an image added in the post body, but nothing for featured images. I just don't get it. 

Occasional Contributor

Definitely need this! Completely agree that I was surprised, there was no place to add alt text to an image file

Regular Contributor

We just had an SEO audit and this issue was identified. Hopefully this will be fixed soon!

Occasional Contributor | Gold Partner

I'm shocked this has been an issue for over 2 years. No alt text option on feature images? Is this even a CMS? I'm a big proponent of Hubspot but this is a glaring oversight.


@BenPutano it is my understanding that an idea needs at least 50 upvotes before HubSpot will review - best thing we can do is share with our teams and get more votes.

Status updated to: Being Reviewed
HubSpot Product Team
Status updated to: Being Reviewed
HubSpot Product Team

Hi everyone,


Thank you all for taking the time to submit your feedback and use cases! We'd very much like to add alt text to featured images for blog, and we're looking into where this might fit into our future plans. I will update this post once we have solidified plans on our end. This might take a while, but rest assured we're thinking about this. 


Please continue to upvote and comment on ideas here in the Community, it's incredibly helpful for us on the product team as we plan and prioritize changes!


- Snaedis 


@Snaedis  am I missing something - or isn't this already done? I noticed while optimizing blogs earlier this week that there is now an Alt Text box below where the featured image is selected for a blog:


Image alt text boxImage alt text box

HubSpot Product Team

jnix284 well, this is embarrassing Smiley LOL you are 100% correct, I completely overlooked that field! Thank you for pointing that out - I will update this post and see myself out Smiley Very Happy

Status updated to: Delivered
HubSpot Product Team

You can add alt text to your featured images! Smiley Very Happy


@Snaedis no worries at all - it literally appeared out of no where one day (I found it because of the SEO photos missing alt tag feature and wanted to complain about getting dinged for it without being able to do anything about it until I clicked through to fix it and it was there). I also wasn't sure if I was in a beta and it wasn't fully rolled out. I probably should have updated the idea when I discovered it, so my bad too 🙂