Jump to content

How do you add Image Alt Text to Section Backgrounds?

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 an company that makes accessibility software for SS sites if you need such software.

Find my contributions useful? Please like, upvote, mark my answer as best , and see my profile. Thanks for your support!

Link to comment
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

Hey, I’m Tyler. 👋 I’ve been a professional Squarespace user since 2016. I’m a recovering startup founder, currently on sabbatical after selling my Squarespace business. I now spend my free time working on weird side projects and half-baked ideas.

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...

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.