Links & Buttons

This occurs when a link has both visible text and a hidden aria-label that say different things. If a screen reader user sees "Read More" but the label says "Global Research Report," it creates a confusing experience. If your link text is already descriptive, an aria-label is unnecessary and should be removed.

How to Fix:

1. Navigate to Content: Go to Manage > Content and use the Filter to search for your specific content item.
2. Enter Edit Mode: Click Edit on the right side of the content item.
3. Locate the Link: Scroll to the Body Content section.
4. Open Source: Click the Source button in the CKEditor toolbar to view the HTML.
5. Clean the Code: Locate the <a> tag and delete the aria-label="..." attribute entirely if the visible text is sufficient.
6. Save: Scroll to the bottom and click Save.

Siteimprove has detected a link on your page that leads to a "404 Not Found" error. This usually happens because a URL was mistyped, an external page was deleted, or the linked internal page hasn't been published yet.

How to Fix:

• Identify the Link Type:
  • In Body Content: You can update the link in Drupal > Manage > Content > Filter (search for the page with the broken link) > Edit > Body Content > Highlight the text > Click the Link icon to update the URL > Save.
  • In Headers, Footers, or Menus: You can update the link in Drupal > Structure > Menus. If you cannot access the menu settings, report it to the Web Team.
• Troubleshooting Steps:
  • The "Incognito" Test: If the link works for you but Siteimprove flags it as broken, copy the URL and open it in a browser Incognito/Private window.
  • Check the Status: If the page fails to load in Incognito, you are likely viewing an unpublished draft that only logged-in editors can see.
  • The Fix: Navigate to the linked page, click Edit, change the moderation state to Published, and click Save.

Learn More: How to manage broken links – Confirm, Review, Dismiss

This is usually a False Positive. The link itself is fully functional for regular users, but the destination website's security firewall is actively blocking the Siteimprove crawler from checking it. No editorial content changes are required.

How to Fix:

1. Verify the Link: Click the link manually to ensure it loads correctly for regular users.
2. Dismiss in Siteimprove: If the link works, you can safely dismiss the flag by following these steps:
   • Navigate to Quality Assurance > Links > Broken Links.
   • Click on the affected page name.
   • Locate the specific link in the Occurrences panel.
   • Click the Settings (Cog) icon next to the link.
   • Select Dismiss Link (forever).
   • Add a mandatory comment to create an audit trail.

Example Dismissal Comment:

"Manual verification confirms this link is fully operational for regular users; HTTP 406/403 status is a false positive caused by a destination firewall blocking the Siteimprove crawler.”

Verify that users navigating via a keyboard can see where their cursor is positioned.

How to Fix:

Open your live webpage and use the Tab key to navigate through the elements. If a clear visual outline/box appears around links and buttons as you move, the focus indicator is working. In Siteimprove, select "Start Review" and follow the confirmation prompts to safely dismiss this potential issue.

Interactive items like buttons or links are flagged for being too small or packed too closely together.

• All Occurrences in the header (e.g. Logo Lockup)
  • a (Rice icon)
  • Rice University
  • Name of your Department
  • button (share)
  • button (search)
  • button (menu button)
• All occurrences in the 'Breadcrumb' menu

How to Fix:

How to Fix: No Action Required (Template Issue): This is a global system template error managed centrally by the Web Team. You do not need to take any action inside Drupal; you can safely ignore or "delist" this item on your department's Siteimprove dashboard.