CMS-Blog

How do I add alt text to featured images on blog listing pages?

Last updated: June 14, 2018

Applies to:

Marketing Hub
marketing-basic-pro-enterprise
Basic, Professional, Enterprise

At this time, a featured image's alt text is not populated on the blog listing page by default. This can cause SEO warnings on listing pages in your page performance tool.

The easiest way to resolve this is to add an alt tag that is populated on the listing page using HubL. Follow these instructions:

  • In your HubSpot account, navigate to Marketing > Files and Templates > Design Tools.
  • Click the name of your blog template.
  • In your blog template, click the Blog Content module
  • In the right sidebar menu under the Edit tab, click Edit listing template to access the HTML of your listing template.

edit-listing-template

  • Add alt="{{ content.featured_image_alt_text }}" to the featured image img tag to populate the alt text on the listing page with the image's alt text as specified in the post editor:
img src="{{ content.post_list_summary_featured_image }}" class="hs-featured-image" alt="{{ content.featured_image_alt_text }}"
  • Alternatively, you can add alt="{{ content.name }}" to the featured image img tag to populate the alt text attribute on the listing page with the blog post's title. 
img src="{{ content.post_list_summary_featured_image }}" class="hs-featured-image" alt="{{ content.name }}"

Please note: including {{ content.name }} in the blog post template might result in HTML code rendering on your post. If you want to print the blog post title without a wrapper on the post template, use the HubL variable {{ page_meta.name }} instead. 

  • Click Publish Changes.

Was this article helpful?

If you still need help you can get answers from the , or to contact support.