TeachWell Digital
University of Auckland logo

Accessibility practices and tools: Alt text

Describe images that convey information.

Alternative text (alt text) helps students who use screen readers understand the content and purpose of images. It’s a key accessibility requirement and a simple way to make your materials more inclusive.

Why it matters

  • Alt text is read aloud by screen readers, enabling blind or low vision students to understand visual content.
  • Students with cognitive or learning disabilities also benefit from brief image descriptions that reinforce meaning.

What to do

DO add alt text that describes the image

 

EXAMPLE:

alt=”Scientific method: observation, question, hypothesis, experiment, analysis, conclusion”

AVOID adding alt text that is vague

 

EXAMPLE:

alt=”Blue diagram with six words”

Scientific method: observation, question, hypothesis, experiment, analysis, conclusion

  • Keep alt text brief—ideally under 150 characters.
  • Avoid phrases like “Image of…” or “Picture of…” as screen readers already indicate that it’s an image.
  • Focus on the purpose of the image, not just what it looks like.
  • For complex images (like charts or diagrams), provide a brief alt text and describe the details elsewhere on the page or in a linked resource.
  • If the image is decorative—such as a logo, border, or icon used only for visual effect—mark it as decorative so screen readers skip it.

Getting it right

In Canvas

Select the image, click ‘Image Options’, and enter a description. If decorative, check the box labelled as ‘Decorative Image’.

Image options in Canvas

In UDOIT Advantage

UDOIT issue identified: “Alternative text should not be the image filename”

  1. Click the ‘Review’ button for more information.
  2. Enter a short description for your image.
  3. If the image is purely decorative, check the box labelled ‘Mark image as decorative’ and click ‘Save’.

UDOIT alternative text. Mark an image as decorative.

 

UDOIT issue identified “Image elements should have an “alt” attribute”

  1. Click the Review button for more information.
  2. Add new alt text to the text field and click ‘Save’.

UDOIT alternative text should be meaningful

 

UDOIT issue identified: “Alt text for images within links should not be empty”

Hyperlinked images should contain alt text.

  1. As above, click the Review button for more information.
  2. Add the new alt text into the text field and click ‘Save’.

 

UDOIT issue identified: “Decorative images should have empty alternative text”

If an image is just for decoration, it should not have an alt text description.

  1. Click the Review button for more information.
  2. If the image is purely decorative, uncheck the box labelled ‘Mark image as decorative’.
  3. Delete the alt text.
  4. Recheck the ‘Mark image as decorative’ box and click ‘Save’.

UDOIT alternative text. Mark an image as decorative.

In Microsoft Word or PowerPoint

Right-click the image, choose “Edit Alt Text”, and add a description or tick “Mark as decorative”.

View more detailed support for adding alternative text in Word or PowerPoint.

In Adobe Acrobat Pro (PDFs)

Use the “Set Alternate Text” tool in the accessibility tags pane to apply alt text.

Add alternate text in the to figures in Adobe Acrobat

Related Canvas Baseline Practices and Universal Design for Learning

Tools and checks

Page updated 21/07/2025 (content refresh)

Send us your feedback

What do you think about this page? Is there something missing? For enquiries unrelated to this content, please raise a ticket with the Staff Service Centre or call +64 9 923 6000.

This form is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.