Quick reference for auditing color contrast, text scaling, and typography rules.
Siteimprove Issues by Name
Color Contrast Does Not Meet Requirements
This issue occurs when the text color is too visually similar to its background color, making it difficult or impossible for users with low vision to read. To meet standard accessibility requirements (AA), text must have a contrast ratio of at least 4.5:1 for normal text and 3:1 for large text (18pt+ or 14pt bold).
How to Fix:
- Adjust Text Formatting (CMS/Drupal Fix): If you manually changed the text color inside the text editor using inline styles, revert it back to the default body text color or choose a darker, high-contrast alternative.
- Use Contrast Tools (CMS/Drupal Fix): If you are picking a custom color combination for a block or component, use the free WebAIM Contrast Checker to test your foreground and background hex codes before saving.
- No Action Required (Template Issue): If the contrast failure is caused by hard-coded theme elements (such as global header colors, main site navigation menus, or default button styles), this is a 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.
Learn More: Color contrast does not meet requirement, explained
Keyboard Focus Indicator is Missing
This issue occurs when the visual outline that appears around interactive elements (like links, buttons, and form inputs) when using the "Tab" key is hidden or removed. Without this visual indicator, keyboard-only users cannot tell where they are currently navigating on the page.
How to Fix:
- No Action Required: In almost all cases across our platform, this flag is caused by a global stylesheet override built directly into the site's central theme. You do not need to make any structural adjustments inside Drupal. The Web Team manages this configuration centrally and handles the codebase updates required to restore standard compliance.
Learn More: Keyboard focus indicator is missing, explained
