Alt text is text associated with an image that some browsers display instead of the image. Search engines use it to identify the content of a page. Adding alt text to images is a great way to give your site an SEO boost and make it more accessible. If you don't manually add alt text to an image, the image's file name usually serves as the alt text.

Alt text is also helpful for assistive screen readers or browsers with images disabled. If a browser can't display the image, the alt text displays instead. When you add alt text, use short, readable terms that describe the image and relate to your site content.

This guide reviews how to add alt text to your site's images, and images that include alt text automatically.

Watch a video

Alt text best practices

When writing alt text, remember that you're writing for humans who use assistive screen readers or who disabled images in their browser. Keep in mind:

• Be descriptive and helpful. How would you describe this image to someone who couldn't see it?
• Keep the text short, typically twelve words or fewer.
• Optimize your text for search by incorporating keywords, but avoid keyword stuffing.
• Write in real sentences; don't use hyphens to separate words.
• You can omit words like "the" and "a," and terms like "photo" or "picture." For example, instead of a picture of a green vase, use green vase.

Image file names

An image's name acts as alt text if there isn't any other alt text added.

To change the filename for most images, re-upload the image with the new name. For example, with image blocks, open the block editor, go to the Content tab, then update the Filename field in the Content tab.

Tip: Only use letters, numbers, underscores, and hyphens in file names.

Site logo

The site title serves as the alt text for the site logo.

Image block

How you add alt text to an image block depends on the layout.

Inline layout

Captions added in the inline layout automatically become alt text for the image.

To add alt text in the inline layout and hide the caption:

1. Add the caption text.
2. Click the Content tab in the image block editor.
3. Click Caption, then select Off.

Note: In lightboxes, captions always display.

All other layouts

For all other layouts (poster, card, overlap, collage, and stack), the captions won't become alt text. Instead, add alt text to the Filename field in the Content tab of the image block editor.

Auto layout and gallery section images

Auto layouts and gallery sections are only supported in version 7.1.

You can add alt text to auto layouts and gallery sections, but each uses a different method.

Auto layouts

If your auto layout has text and images, you can add alt text to the images in that section. Auto layouts that don't have both text and images don't support alt text.

To add alt text to items in auto layout sections:

1. While editing a page, hover over the auto layout section and click Edit Content.
2. Click the Content tab.
3. Click the image you want to add alt text to.
4. Scroll to Image Alt Text and enter your alt text in the field.
5. Click Back, then click Save.

If the Image Alt Text field doesn't appear, the auto layout doesn't support alt text.

Gallery sections

Gallery sections primarily showcase images. If you add a description to gallery section images, it automatically becomes alt text and the caption for the image.

Gallery block images

In version 7.1 you can only add gallery blocks to blog posts, product items, and individual events.

To add alt text to an image in a gallery block:

1. Double-click the gallery block or click Edit.
2. Find the image to edit, hover over it, and click .
3. Add alt text to the Enter an image title field. If you don't add an image title, text in the description field becomes alt text.
4. Click Save.

Blog post and event thumbnails

The title of a blog post or event serves as the alt text for the post or event thumbnail. For Event Pages, this is the same on both list and calendar layouts.

Page thumbnail image

File names serve as alt text for page thumbnail images. Ensure that you name all thumbnail images as you want them to appear before uploading them.

Video block thumbnail image

When you add video blocks to your page using a URL, the block automatically generates a thumbnail image and appears as an overlay. If you add a custom thumbnail, the file name appears in the static URL, but not as alt text. It's not possible to add alt text to video block thumbnail images.

Product images

How you add alt text to a product image on the store page depends on the product editor you're using:

Cover page images (version 7.0)

To add alt text to a cover page image:

1. In the cover page menu, click the Media panel.
2. Hover over the image and click .
3. Add alt text to the Enter alt text… field.
4. Click Save.

Gallery page images (Version 7.0)

To add alt text to an image in a gallery page:

1. Click the gallery page in the Pages panel.
2. Find the image to edit, hover over it, and click .
3. Add alt text in the Image Title field. If you don't add an image title, text in the description field becomes alt text.
4. Click Save.

Next steps

• For more SEO tips, visit How do I increase my site visibility to search engines?
• To learn how to make your site more accessible, visit Making your Squarespace site more accessible.