To make content accessible and enhance SEO, adding alternative text (alt text) to images is essential. This guide explains how to effectively implement alt text across different content types.

Best Practices for Alt Text:

• Keep descriptions under 12 words
• Use clear, descriptive language
• Include relevant keywords naturally
• Write complete phrases without hyphens
• Omit unnecessary words like "the," "a," or "photo"

Image File Names: If no alt text is added, the image file name becomes the default alt text (except for image blocks and layout sections). Update file names in your resource library following alt text best practices.

Adding Alt Text to Different Content Types:

Image Blocks:

• Click Content tab in editor
• Enter alt text (up to 250 characters)
• Changes save automatically

Gallery Sections:

• Image descriptions automatically become alt text and captions
• Edit individual images through the gallery editor
• Save changes after adding descriptions

Product Images:

• Hover over product and double-click
• Click Edit metadata on image
• Add alt text (up to 200 characters)
• Click Apply

Blog and Event Featured Images:

• Post/event title automatically serves as alt text
• No additional configuration needed

Email Campaign Images:

• Select image section in campaign draft
• Add alt text in right panel
• Changes save automatically

Background Images:

• Cannot add alt text directly
• Use image blocks as backgrounds if alt text is needed
• Consider custom code solutions for advanced implementations

Important Notes:

• Site logo uses site title as alt text
• Featured page images use file names as alt text
• Video thumbnails cannot have custom alt text
• Decorative images don't require alt text per accessibility guidelines

The proper implementation of alt text improves both accessibility and search engine optimization while ensuring your content reaches the widest possible audience.

Note: Different platforms may have slightly different implementation methods. Always consult your specific platform's documentation for detailed instructions.

Related Articles

Previous Articles