Topics Map > Canvas > UDOIT Cloud Accessibility Tool

UDOIT - How to Resolve Image Alternative Text Errors

Images are an essential part of compelling online instructional content. However, they need to be used in a way that is accessible to all students, including those using screen readers and other assistive devices to learn. This guide explains how to resolve any alternative text errors identified by the UDOIT Digital Accessibility tool in Canvas.

What is "Alternative Text" for Images?

When using images on a web page, like in Canvas, always include meaningful and descriptive alternative text that summarizes the meaning of an image in digital content. In other words, describe what it is and why you've included it on your page.

Screenshot of the Canvas "Upload Image" tool, including a place to type descriptive "Alt Text"
When uploading an image to Canvas, always enter descriptive Alternative Text in the "Alt Text" text entry box.

The screenshot below shows a Canvas page with an inaccessible image that needs to be corrected. The image may look correct, but it's missing alternative text, so a UDOIT scan will identify it as an accessibility error.

Screenshot of a page in Canvas that has an image of UWS and text welcome to class hope you are enjoying the beautiful weather.
There are no visible indicators that this image is inaccessible, which is why it is important to use the accessibility checkers that are available in your Canvas course.

How Do I Write Alternative Text?

Writing good alternative text (alt text) for images involves clearly and concisely describing the content and function of an image for users who cannot access the image. Effective alt text conveys the essential information without being overly detailed or vague. It should be context-specific, meaning it reflects the image's role within the surrounding content.

Example of Acceptable Alt Text:

Alt text: "A golden retriever puppy playing with a red ball in a grassy park."

Examples of Insufficient Alt Text:

Alt text: "Dog."

This is too concise, it leaves out critical information to understand the image.

Alt text: "Image of a dog playing."

Phrases such as “image of” or “graphic of” are redundant because a screen reader or "image unavailable" icon will indicate that this is an image. However, you should include language in your alternative text that gives the reader a better understanding of what's depicted in the image. For example, "Screenshot of" may be used to give context or a photo could be described as a "Portrait photo", "Landscape photo", or "Macro photo" to be more specific about the composition.


Types of Alternative Text Errors:

Error: Alternate Text should not be the File Name

When you copy and paste an image into a Canvas page it automatically applies “image.png” as the alternative text. This will trigger an alert from the Canvas accessibility checker which will allow you to add alt text directly from the page.

Screenshot of the edit screen in Canvas for the Alternate Text page with an image of UW-Superior Campus. There is an accessibility icon alert highlighted on the bottom of the page. Screenshot of the Accessibility Checker on a Canvas page with image.png as the alt text for an image.
Click the Accessibility icon to open the Accessibility Checker. Use the text box within the checker to add new alternate text to your image.

If you are scanning your course with UDOIT, this automatically applied alt text will trigger the “Alternate Text should not be the File Name” error.

Screenshot of the Alternate Text should not be file name screen in UDOIT. The alt text says image.png and the picture is of UW-SUperior Campus.
UDOIT is helpful to remediate accessibility errors across your whole course. If you have multiple images with no alt-text, we recommend using UDOIT.

To resolve this error, type a new alternative text into the text box.

Screenshot of error page with new alt text added. Text describes photo and weather conditions on campus.
Saving your new alt text on this screen will apply the changes to your Canvas page.

Error: Alternate Text is More than the Maximum Allowed Characters

Although it is important to convey necessary information in your alt text, you should limit the text to under 150 characters. If you find yourself struggling to condense the information to this degree, consider adding text to the surrounding page to support the image.

If your alt text is too long, UDOIT will prompt you to condense it.

Screenshot of the Alternate Text is more than the Maximum Allowed Characters UDOIT screen. The current alt text is 168 characters.
Make sure you consider carefully what essential information needs to be included in the alt text.

Edit the text in the UDOIT error page New Alt Text textbox. UDOIT will not allow you to save the text until it is under 150 characters.

Screenshot of the resolved error screen with shortened alt text. A sentence about cleared sidewalks was removed.
150 character is the upper limit. Shorter alt texts can be effective if they contain all essential information.


Keywords:
Accessibility, Alt text 
Doc ID:
149904
Owned by:
Kasey S. in UW Superior
Created:
2025-04-16
Updated:
2025-04-16
Sites:
UW Superior