KB Users Guide - General Info - Updating Missing Image Alt Tags

This document is specific to the Classic Editor, which is being retired. We recommend trying these steps in the TinyMCE if possible. Please browse our documentation on TinyMCE for help.

This document walks you through how to identify the location of your missing alt tag and how to update it.

Alt Tag Error Message from the KB System

kb error message missing 1 image alt tag

The image above, "Missing 1 image alt tag in document body",  indicates alternative text is missing from an image in your KB document. Upon receiving this message, you will not be able to save your work until the alternative text for the image is in place.

Add Missing Alternative Text to Image

  1. In the KB editor, open the document in the HTML Code view

  2. Find image with missing alternative text by enabling the Find feature in your browser.


    • Mac - Command + F
    • PC - Control +F

    A search field will open, commonly in the lower left of the screen. The image below shows a browser Find text box.


  3. Enter "img" in the browser search field and locate the first img. If you have more than one image, you'll have to identify which image is missing its alternative text. The image below shows the HTML Code view of two images highlighted in yellow for emphasis.


    The first highlighted image has a purple box around the alternative text:

    alt="open in progress close"

    The second highlighted image has no alternative text.

    Insert the below alternative text attribute to your image:

    alt="enter your descriptive text between these parentheses"

    Once you have added the alternative text to the image, save your document as per your KB Group's workflow.

    Alternative Text (Alt text)

    Alt text is also known as:

    • alt attributes
    • alt descriptions
    • alt tags

    They are used within HTML code to describe the appearance and function of an image on a page for web accessibility and for those using a screenreader. 

    Alt Text uses

    Adding alternative text to images is first and foremost a principle of web accessibility.

    • Visually impaired users using screen readers wil read an alt attribute to better understand an on-page image.
    • Alt text will be displayed in place of an image if an image file cannot be loaded.
    • Alt text provides better image context/descriptions to search engine crawlers, helping them to index an image properly.


    Write Effective Alt Text 

    The KB Team recommends the guidelines below to write effective alt text for document images


Keywords:alternative alt attributes descriptions alt text image attachment can't save code view   Doc ID:111803
Owner:Leah S.Group:KB User's Guide
Created:2021-06-19 10:01 CDTUpdated:2022-06-15 17:18 CDT
Sites:KB User's Guide
Feedback:  0   0