Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleAdding Alt Text for Images

Limit the use of decorative graphics and images. Rely on text-based content rather than embedding all content in an image, such as a flyer. This approach avoids issues for users whose email clients block images or use screen readers.

...

in Emails

Alt text is a short description displayed in place of an image when content is read by a screen reader, or images are being blocked. Include descriptive and concise alt text for all images, enabling screen readers to describe them to visually impaired users. The email loses all meaning without alt text when the image does not load.

Best Practices

  • Alt text should be concise and descriptive.

  • Avoid duplicating text already present in the email body.

  • Limit the use of decorative graphics and images. Rely on text-based content rather than embedding all content in an image, such as a flyer. This approach avoids issues for users whose email clients block images or use screen readers.

  • If an image contains text (e.g., banners or event flyers): Ensure the text is also included in the email body or alt text.


How to Add Alt Text

...

in Emails

  1. Open the Email:

    • Navigate to Marketing > Email in your HubSpot account.

    • Open an existing email or create a new one using the Drag-and-Drop Editor.

  2. Add or Select the Image:

    • Click on the image module where you want to add alt text.

    • If the image isn’t already uploaded, click Replace to add an image.

  3. Add Alt Text:

    • In the Image Settings panel on the right, find the Alt text field.

    • Enter a concise and descriptive alt text that conveys the purpose of the image.

      • Example: “Student holding books at Maricopa Community College.”

  4. Save Your Changes:

    • Once added, click Done or Save to ensure the alt text is applied.


  • Keep Layout Simple

    • Use a single-column layout to enhance readability, reduce sensory overload, and ensure device compatibility.

    • Use color combinations that are easily readable to low-vision users and users who have difficulty differentiating color. Avoid using background effects with images or patterns that lower the text-to-background contrast.

  • Adequate Color Contrast

    • WCAG recommends using a contrast ratio of at least 4.5:1 for standard text (and 3:1 for larger text) to assist those with visual impairments.

    • Provide enough white space around elements to prevent crowding, helping users visually differentiate and navigate content easily.

...