Jump to content

How do you add Image Alt Text to Section Backgrounds?

Go to solution Solved by tcp13,

Recommended Posts

20 hours ago, tuanphan said:

You mean add alt text, or add a small text under background image?

I mean add Alt text to the background image.  There's nowhere in the settings to add the text unlike with normal image settinds.  Is it possible to code the alt text to the image in the custom CSS?

Link to comment
  • 2 months later...


You mention both background and block images.

Image blocks do have an optional file name that can be set which translates to the alt text.





It does appear that background images for sections do not get an alt text. At the very least they could add the file name in alt text. Even better would be to add the optional file name field to the background image settings dialog.

FYI @tcp13 works for a company that makes accessibility software for SS sites if you need such software.

Edited by creedon

Find my contributions useful? Please like, upvote, mark my answer as the best ( solution ), and see my profile. Thanks for your support! I am a Squarespace ( and other technological things ) consultant open for new projects.

Link to comment
  • Solution
On 5/27/2021 at 8:34 PM, creedon said:

FYI @tcp13 works for an company that makes accessibility software for SS sites if you need such software.


Hey hey! I'm a certified Web Accessibility Specialist and the founder of Square ADA. Great question @KickinGa!

WCAG (the golden standard of web accessibility) actually states in SC 1.1.1 that if an image is "pure decoration" or "used only for visual formatting," then it should be "implemented in a way that it can be ignored by assistive technology."

Translation - If the image isn't communicating any meaningful information, then we assign a null alt attribute to tell screen readers it's okay to skip the image (WCAG Technique H67). When used correctly, null alt text provides a better experience, since blind folks typically don't care about every little decorative icon or scenic background photo when trying to find information on your site.

In the case of the 7.1 site you linked (and @herobirthservices mentioned), the null alt tag is already assigned by Squarespace on all background images. So from an accessibility standpoint, this is technically compliant.


However, if there's meaningful content in the background image that needed to be assigned alt text (such as using an image of text), you could use custom code to override the default null value:

<!-- jQuery -->
<script src="https://code.jquery.com/jquery-3.5.0.min.js"></script>

<!-- Override Alt Text Value -->
    $("section[data-section-id='5f5726f0974f98058a7f632f'] .section-background img").attr("alt", "Lorem Ipsum");

Hope this helps!

Edited by tcp13

The above post may be outdated. I’m no longer active in the Squarespace ecosystem, so I won’t see your direct messages. For better resources about web accessibility, I’ve documented some of my thoughts on my forum profile.

Link to comment
  • 1 year later...
  • 5 months later...
  • 1 month later...

Making another request that background images be given the option for alt text.

As @tcp13 mentioned, there may be a null alt tag assigned to background images which makes them technically compliant, but they still get caught by accessibility scanners.

Clients in industries which tend to be concerned with compliance do not understand this.

Link to comment
  • 2 weeks later...
  • 2 weeks later...
  • 3 months later...

I'd like to ad my concern about the lack of ability to assign alt text to images all over Squarespace 7.1. We are unable to add alt text to images to a featured blog post image, inside a gallery, or page section backgrounds. Not giving us the option to ad alt text to these specific images is strange or an oversight and I am unable to conclude an good reasoning why we should be limited in this way. If an image needs an "null" assignment we should have the ability to make that choice. Loading jquery to make the change is an overly complicated and resource intensive way to make such a simple change; and, will ultimately negatively impact the loading speed of the page or search engine ranking of the site.

Link to comment

I agree with the past posters on this thread.  Alt Tags are a fundamental part of SEO and not giving us the ability to edit this in all places feels like I'm walking around without wearing a sock.  I can still walk, but it's awkward...  

Edited by CraigAds
Link to comment
  • 2 weeks later...

I guess we need to use code to add alt to section background image. If you still need, please share link to page where you added image + Let me know which text, we can give code

Email me if you have need any help (free, of course.). Answer within 24 hours. 
Or send to forum message

How to: Setup Password & Share url Insert Custom CSS - Page Header - Upload Custom Font - Upload File - Find Block ID - Contact Customer Care

Link to comment
  • 2 weeks later...
  • 2 weeks later...

Create an account or sign in to comment

You need to be a member in order to leave a comment

  • Create New...

Squarespace Webinars

Free online sessions where you’ll learn the basics and refine your Squarespace skills.

Hire a Designer

Stand out online with the help of an experienced designer or developer.