Note: While our most popular guides have been translated into Spanish, some guides are only available in English.

Adding alt text to images

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.

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 will display instead. For all these reasons, when you add alt text, use short terms that describe the image and relate to your site content.

You can add alt text to images directly in these areas:

• Image Blocks
• Gallery Page images
• Gallery Blocks
• Product images
• Cover Page images

In these image areas, file names usually serve as alt text:

• Page thumbnail images

Note: If you don't manually add alt text to an image, the image's file name will serve as alt text.

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.

If your image is set to the Inline layout, and you want to add alt text but not display a caption:

1. Add the caption text.
2. Select Do Not Display Caption.

Note: In lightboxes, captions always display.

All other layouts

For all other layouts (Poster, Card, Overlap, Collage, and Stack), the captions don't become alt text, but you can add it by switching temporarily to the Inline layout:

1. Double click the Image Block to open the image editor.
2. Click the Design tab.
3. Choose the Inline layout (for blocks on Regular Pages only).
4. Ensure the caption is set to Caption Below.
5. Click Write here below the image to add your alt text.
6. In the image editor, switch back to your preferred layout.
7. Click Save.

You can add and edit the two text fields for the Image Block without disrupting the alt text. To adjust the alt text, switch temporarily back to the Inline layout.

Gallery Page image

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

3. Add alt text in the Image Title box.
4. Click Save.

Note: Text added to the Description box won't serve as alt text.

Gallery Block image

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 the .
3. Add alt text to the Image Title box.
4. Click Save.

Note: Text added to the Description box won't serve as alt text.

Product image

To add alt text to a product image on the Product Page:

1. Hover over the product and click Edit.
2. Find the image to edit, hover over it, and click the .
3. Add alt text to the Image Title field.

Cover Page image

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 the .
3. Add alt text to the Enter alt text… field.
4. Click Save.

Thumbnail image

File names serve as alt text for thumbnail images, except when thumbnail images appear as blog post banners, in which case the blog post title serves as alt text. Ensure that you name all thumbnail images as you want them to appear before uploading them.

Next steps

• For more tips on SEO, visit How do I increase my site visibility to search engines?
• For more tips on making your site accessible to people with disabilities, visit Making your Squarespace site more accessible.