Resolving Accessibility Issues

Resolving Accessibility Issues

When you see issues listed in the Accessibility Suggestions window pane, you can resolve them in a couple of different ways. If the issue has to do with missing alternate text, you can use the Apply Accessibility Suggestions Wizard to automatically add this to the elements in question; you can also add empty alt text to multiple images at once. If the issue has to do with alternate text or something else—such as missing captions, labels, or table header elements—you can fix the issue manually in the user interface.

How to Resolve Accessibility Issues (Alt Text) Automatically in a Wizard

1. Open the Accessibility Suggestions window pane. See Viewing Accessibility Suggestions.
2. In the Accessibility Suggestions window pane, select all "alt text" issues that you want to resolve. If you want to select all rows click . You can hold the SHIFT key to select a range, or you can hold the CTRL key to select individual items.
3. In the local toolbar, click the Apply Alt Text button.
4. A message asks if you want to apply the selected suggestions. Click OK. The Apply Accessibility Suggestions Wizard opens.
5. Select one or more items in the list. (Select multiple items if you want the same alt text to apply to them all.)
6. (Optional) If you selected only one item, you can click View, which opens the Media Viewer and lets you see a preview of the object (e.g., equation, QR code, image, video). For videos and images, file information is displayed in addition to a list of files that link to the media file. Click OK when you are finished.
7. Click Set Text. The Change Alt Text dialog opens.
8. In the Alt Text field, you can enter the alternate text for the object (e.g., description of the image that you want screen readers to interpret). If you want to apply empty alt text to image(s) that you selected, leave the field blank.
9. Click OK.
10. If you are setting different alternate text for different items, repeat steps 5-9 for each item in the wizard.
11. Click Next. A preview of your settings is shown.
12. Click Finish.

13. Click OK.

    Note If you want to undo the conversions, you can use the Backups window pane (View > Backups). See Restoring Backup Files.

How to Resolve Accessibility Issues Manually in the Interface

1. Open the Accessibility Suggestions window pane. See Viewing Accessibility Suggestions.

2. Double-click on any file in the list to view or modify it.

3. Depending on the type of issue, use the appropriate areas of the interface to make changes:

   • Image Elements You can fix the issue by editing the image and entering a description in the Alternate Text field. See Editing Images.
   • Equation Elements You can fix the issue by editing the equation and entering a description in the Alternate Text field. See Editing Equations.
   • QR Code Elements You can fix the issue by editing the QR code and entering a description in the Alternate Text field. See Editing QR Codes.
   • Tables You can fix the issue by editing the table properties and entering caption text (above the table) and/or adding a header row. See Editing Table Properties.
   • Form Elements You can fix the issue by opening the markup for the document and adding a label to the form. To edit the markup, you can use the Internal Text Editor or Notepad. For more information about working with form elements (and labels within them), see w3.org.
   • Frame Elements You can fix the issue by opening the markup for the document and adding a title to the frame element. To edit the markup, you can use the Internal Text Editor or Notepad. For more information about working with frame elements (and titles/names within them), see w3.org.