Skip to main content
Pepperdine | Community

Helpful ALTernatives

Learn how to add alternative (ALT) text descriptions to your visuals to reach every reader.

Accessible Images banner with icons for a photo, a text description, and the Universal Access accessibility logo.

Welcome to this month's Digital Accessibility topic, the "A" of HEAL: Alternative Text. Our November post is a collaboration with the Office of Student Accessibility. We hope you enjoy Part 3 of 4 in the HEAL Framework blog series.

Quick Summary

  • Consider the purpose of visual (non-textual) content in digital materials—is it meant to decorate or communicate?
  • Add alternative text descriptions to images that concisely describe the point of the content. (The why is often more important than the what.)
  • Mark purely decorative images as such.
  • Avoid placing important text in images; place key text directly on the page.
  • Filenames are not acceptable alt descriptions.

Who Should Read This Article

  • All faculty.
  • All employees who create email messages, documents, webpages, etc.

The Power of Alternative Text

Have you ever tried to visit a webpage, open an email, or download content over a sketchy Wi-Fi connection? We’ve all been there—waiting for the content to load, seeing the loading bar progress, finally seeing the words appear—only for the graphic, photo, or diagram we were waiting for to show up as a broken image (pictured below). 

Google Chrome Broken Image Icon of an image on a page with a slash through it.
Figure 1: Google Chrome Broken Link Icon

Or imagine navigating a webpage using a screen reader, arriving at the graphic, and hearing the software read “Image” and nothing else. It is true what they say: "A picture is worth a thousand words." A picture can also be a challenge to load if it's a high-resolution photograph or illustration. Pictures can also be difficult to process by screen readers without your assistance. Our images often convey important information or context to our readers, so being unable to access or understand the non-textual content is detrimental to their understanding, learning, and experience with our material.

The fix is easy: Add alt text to your images, charts, and other visuals.

Who Benefits from Alt Text?

  • Diverse Communities: We can reach more people, especially anyone who uses assistive technologies, by adding alt text to our visuals.
  • Users with Slow Internet: Anyone with weak internet connections will still be able to read the alt text if a visual fails to load.
  • You! Adding alternative text to images encourages critical thought about the purpose and message of your non-textual content.

Best Practices for Alt Text

When you write alternative text, please consider the following best practices.

CheckboxPrioritize Context Over Content

Reflect on why you included the image. What is the lesson you wanted to communicate or enhance? A photo by Ansel Adams of El Capitan in Yosemite would have a vastly different purpose in a photography class than a lecture on national parks in a US History class. Therefore, alternative text is rarely a one-description-fits-all process. Focus on the concept, takeaway, and reason for the visual, and describe the content in that context.

CheckboxKeep Alt Text Brief and Descriptive

Limit your description to one or two sentences (try for 120-150 characters max). Get to the point quickly and let your surrounding prose or figure caption communicate deeper meaning or connections. Drop any meaningless openings like "Image of..." or "Picture of..." Screen readers will introduce the visual as an image.

CheckboxMark Purely Decorative Visuals as Decorative

If a graphic has been added for purely aesthetic reasons (page borders, abstract backgrounds, or fun clip art), mark the visual as decorative. Applications like Microsoft Word and Google Docs, as well as learning tools like Canvas LMS, offer image options to "Mark as decorative." On a webpage, leave a null alt attribute (i.e., alt=""). This way, assistive technologies will skip over the image.

CheckboxExplain the Action for an Image with a Link

When an image includes a link, such as a registration button or an email banner graphic, explain what happens when someone follows the link, not just the content of the visual. For example, if the image provides access to a feature, such as a search button, describe the function (search) and don't worry about the graphic (magnifying glass icon). If a link is on a banner graphic, describe the graphic and explain where the link will take the user.

CheckboxDouble-Check any AI-Generated Alt Text

If a tool offers to automatically generate alt text using artificial intelligence (AI), always verify AI output and update the description to reflect the visual's context and function if needed.

Checkbox with X markDon't Place Critical Text in an Image

Except for charts or graphs, don't place critical text information in an image. Key details, such as dates, times, and locations, should be placed within searchable text on the page or in the body of the document. If using a primary historical source, however, that contains significant text, transcribe the text in your alt text, adjacent body copy, or in an appendix.

Checkbox with X markFilenames Are Not Descriptions

A filename, like "image.jpg" or "banner-graphic.png," is not an acceptable alternative text description. While you should always use meaningful filenames to help you find and select graphic files on your computer, devices, or websites, don't rely on the filename to explain the visual.

Alt Description Examples

The following table provides samples of effective and ineffective alt text for common visual categories.

Table of Example Alt Descriptions by Category
Category of Visual Effective Alt Text Poor Alt Text
Historical Photograph Black-and-white photograph of civil rights demonstrators marching across the Edmund Pettus Bridge in Selma, Alabama, in 1965. Picture of protesters walking with signs.
Bar Chart Bar chart comparing U.S. unemployment rates from 2019 to 2024, showing a spike to 14.8% in April 2020 followed by a steady decline to under 4% by 2024. Chart of unemployment rates.
Decorative Graphic [Mark it as decorative or set alt=""] blue-wavy-lines.jpg

How to Add Alternative Text

Want to learn how to add alternative or alt text descriptions to visuals on popular platforms? Please select a tool below to expand and find instructions.

  Pepperdine Gmail

Add Alt Text to an Image in Gmail

  1. Open Pepperdine Gmail.
  2. Select Compose to create a new email message.
  3. Type your email message.
  4. Add an image.
  5. Select the image and choose "Edit alt text." 
  6. In the "Alt Text" window, use the Description field to describe the purpose, content, and/or context of the image.
  7. Select Apply to add the description to your image.

Refer to the Google Help article "Add alt text to an image (Gmail)" for more information.

  Google Docs

Add Alt Text to an Image in a Google Doc

  1. Insert an image in your Google Doc.
  2. Right-click the image and choose Alt Text from the contextual menu. You may also use the Ctrl-Alt-Y (PC) or Command-Option-Y (Mac) keyboard shortcut.
  3. The Image Options side panel will display with the Alt Text section available.
  4. Enter the description for the image in the "Describe the image" field.
  5. Close the Image Options side panel when done.

Refer to the Google Help article "Make your document, presentation, sheets & videos more accessible (Google Workspace)" for more information.

  Microsoft Word

Add Alt Text to an Image in a Word Document

  1. Insert an image in your Word document.
  2. Use one of the following options:
    • Right-click the image and select "View alt text."
    • Select the image, choose the Picture Format ribbon, and select the Alt Text command in the Accessibility group.
  3. In the Alt Text pane, enter the description in the field.
  4. Close the Alt Text pane when finished.

Refer to the Microsoft Office Support article "Add alternative text to a shape, picture, chart, SmartArt graphic, or other object (Microsoft Office)" for more information. 

  Pepperdine Canvas LMS

Add Alt Text to an Image in Pepperdine Canvas

  1. Add an activity or page (or edit an existing item) in Pepperdine Canvas.
  2. In the rich content editor, insert an image.
    • During the file upload process, enter the Alt Text description in the Attributes section.
    • Complete the image upload.
  3. If editing an existing image, select the image and choose Image Options.
    • Enter the Alt Text description in the available field.
    • Select Done to add the alt text description to the image.

Refer to the Instructure Canvas LMS support article "How do I manage alt text and display options for images embedded in the Rich Content Editor? (Canvas LMS)" for more information.

 

Additional Resources

Thank you for supporting all members of our Pepperdine community by adopting digital accessibility best practices!

 

CREDITS: The banner image, Google Chrome broken image figure, and example ALT text descriptions in the data table were created with assistance from Google Gemini.