Image used as anchor is missing valid Alt text


Under the Accessibility Final Checks I receive the Known Problem: Image used as anchor is missing valid Alt text.


  • Omni CMS


Potential problems are either code that may cause errors or possible errors that cannot be automatically checked and require human review.

Omni CMS Final Checks look over all the code on a page and detect accessibility issues that do not meet WCAG 2.0 (Level AA) standards. It has detected the page contains an image missing an alternative description. These descriptions aid non-sighted users understand the image and what it displays, as well as provides text if an image fails to load.


Add an alternative description to all images on the page. Image alt descriptions should be less than approximately 125 characters while remaining as descriptive as possible. 

Rather than a short description like "students walking," describe the entire scene (ex., "Two WKU students walking through a shaded part of main campus on a sunny day.").

Tip: Avoid using images with text in them. If you must use an image with text, be sure that all text contained in the image is typed out in the description.
  1. Check out the page if it is not already.
  2. Click the  Edit tab.
  3. Click the  Edit Button on the content area where the image identified in the source code section of the error is located.
  4. Edit the Image and shorten the alternative text.
  5. Save the page.
  6. Click the Publish button to run the accessibility final check again. When the issue has been resolved it will no longer display in the accessibility check.



Example - Source Code:<img class="d-block img-fluid mx-auto" src="

If the source of the image contains the class and src in the source code, this means there is a Gallery Asset on the page containing images that are missing the alt description. Ensure all images have the caption field completed under the Images section.

  1. Edit the Gallery asset on the page.
    • In the top navigation, click Content -> Assets for a list, then filter by name.
  2. Check out the asset and Edit.
  3. In the Images section, fill out the Caption field and add a meaningful description.
  4. Save the Gallery
  5. Publish



Article ID: 3882
Thu 11/18/21 12:58 PM
Tue 11/23/21 9:46 AM

Related Articles (4)

Instructions to fix the accessibility final check potential problem: Image Alt text may be too long.
Instructions for adding a slider (carousel image gallery) to the top of a page above the page's title and content in the new Site Template.
Instructions for creating a grid gallery asset in Omni CMS.
Instructions for using the accessibility check feature of final checks when publishing a page.