Enhanced Annotations

  • Authors: George Kerscher, Noelia Ruiz Martínez

In the DAISY Consortium, best practices are developed for publishers and authors for providing extended (long) descriptions.

The best practices use the HTML details element that follows the image, or a link to another file that contains the extended description.

In both options, the user would need to move to the details or the link and activate it.

Having a keystroke to put focus on the details or the link is ideal.

Our best practices recommend that the details or the link immediately follows the image, and if the link is followed, a back link to the exact location must be provided. This makes it certain that the user will not get lost.

However it is probable that authors in the wild will place the extended (long) description almost anywhere. In these cases, the user would want to return to the image and hence the need for a way to return to the original image.

This add-on provides both features, in support of this issue opened in NVDA's repository.


  • NVDA+alt+d: moves the cursor to the element identified with aria-details.
  • NVDA+alt+shift+d: moves the cursor to the original element, for example, an image with furter details like a long description. If NVDA+alt+d has been pressed several times to move to related annotations, it'll be possible to go back to each origin.

The above commands can be modified from NVDA's menu, Preferences submenu, Input gestures dialog, Browse mode category.

Changes for 2.0

  • Added ability to move back through multiple annotation origins.
  • Requires NVDA 2023.1 or later.