Common Link Accessibility Issues


Link Issues

Warning: Alternative text for image is identical to link text.

Issue: The alternative text for an image link is a repetition of the adjacent link text.

Resolution: Choose one of the following: If the image is also a link, combine image and link to avoid redundancy. If the image is not linking, the link text is sufficient information and there should be no alternative text for the image (empty alt attribute).


    Warning: Image link is missing alternative text

    Issue: The image link is missing an alternative text stating the purpose of the link.

    Resolution: If for instance it links to a web page, state the topic of that page.


      Warning: Adjacent links used for same destination

      Issue: Adjacent links, one with a link text, the other with an iconic representation of that link, point to the same destination.

      Resolution: These should be combined as one link.


        Warning: Should adjacent links be combined

        Issue 1: Adjacent links, one with a link text, the other with an iconic representation of that link, might point to the same destination. 
        Resolution 1: If the destination pages are not the same, this is not an issue.

        Issue 2: One of the links has been created using the WAI-ARIA role="link" and a manual review is needed to determine if the two links point to the same destination.

        Resolution 2: If the destination page is the same, the links should be combined.


          Warning: Local link destination does not exist.

          Issue: A local link (anchor link) occurs but the destination does not exist.

          Resolution: When using local links they must refer to an existing element on the page.


            Warning: Link text is too generic in its current context

            Issue: The link text is generic text that does not identify the link purpose. The link does not seem to have any programmatically determined link context that can aid in identifying the purpose either.

            Resolution: Link texts should be written so they make sense out of context. Generic texts such as “Click here” and “More” give no indication as to the destination of the links.


              Warning: "Longdesc" attribute does not link to an existing resource

              Issue: The 'longdesc' attribute is used on the image. But it does not link to an existing resource.

              Resolution: If ‘longdesc’ is used to give a short alternative text for the purpose of the image, use the alt attribute instead. 'longdesc' is to be used where a text is needed to explain the image in detail, providing a link to a page with the description.


                Warning: ?

                Issue: ?

                Resolution: ?


                  A local link (anchor link) occurs but the destination does not exist. When using local links (bookmarks) they must refer to an existing element on the page.