Accessible images in TDX knowledge base articles

Knowledge articles should only have relevant images that contain information that adds to the text content. Do not use purely decorative images that do not contribute to the understanding of the content. Do not use images of text if at all possible. Service descriptions will typically not contain any images.

All images must have an alt tag (alternate text) with the appropriate text to describe the image.

Alternate text for screenshots showing where to click should describe the location of the link or button on the screen.

To ensure web accessibility, see W3C's pages on:

Insert an image in a knowledge base article or service description

screenshot showing the Image button

Saving images and uploading them to TDX to insert into an article usually has better results than copying and pasting the image into the editor.

To upload an image to display in an article and include the alt tag:

  1. Click the Image button to insert an image, or select an image and click the Image button to change the image information. The Image Properties window will open.
  2. Click the Upload tab in the Image Properties window to upload an image.
    Note: If the image has been used in a different article, you can use that image instead of uploading it again. Find the image in the article where it has been used. Right-click on the image, and select Copy Image Link/Copy image address. Paste the address into the URL field.
  3. Click Browse to find the image file.
  4. Click Send it to the Server to upload the image.
  5. Under the Image Info tab, complete the Alternative Text field with a description of the image that includes any depicted text, instructions, or other information.
    All images must have alt tags!
    • Under the Image Info tab, the height and width can be changed. A Lock Ratio button is available.
    • To make the image a link, under the Link tab, type the link URL in the URL field. Be sure to describe the link in the alternative text.
    • To have the link open in a new window/tab, select New Window from the Target dropdown under the Link tab. Links that open external sites should open in a new window/tab.