Overview of Alt Text

Keep in mind the following points. Credit for the following list goes to https://webaim.org/techniques/alttext/ .

Adding Alt Text in the Insert Image Dialog Box

Confluence supports adding alternative text in the Image Properties dialog box.

  1. In the page you want to change, click Edit
  2. Select the image. The image properties panel appears. 
    Image properties menu
  3. Click Properties. The Image Properties dialog box appears. 
    Image Properties dialog box
  4. In the Alt text field, enter alt text. Until CONFSERVER-34728 has been fixed, avoid using the following special characters in alt text:

    Do not add text in the Title text field.

Adding Alt Text in the Source Editor 

To enter alt text in the Source Editor (XHTML), enter the ac:alt attribute in the ac:image element as follows.

<ac:image ac:alt="caDSR logo">

Until CONFSERVER-34728 has been fixed, avoid using the following special characters in alt text:

  • forward slash (/)
  • colon (:)
  • question mark (?)
  • double quote (")
  • semi colon (;)

An image inserted this way has alt text, which is evident to the user of a screen reader for the following image. 

caDSR logo

Checking Alt Text

To view the alt text, you can display the image properties in your browser. To view alt text inline with the images, consider using a checker such as the WAVE Web Accessibility Evaluation Tool, available at the following site:

https://wave.webaim.org/