Accessibility
· 13 checks — Landmarks, headings, alt text, forms, and link quality rolled into one auditable list.DLandmark StructureAction1 landmarksFIX
Screen reader users cannot quickly navigate to the primary content. Wrap your main content in <main>.
Without a <main> landmark, screen-reader users can't skip past the navigation to the page content — every page starts with re-reading the menu.
Learn more ▾ ▴
The <main> element marks the page's primary content area. Assistive tech offers a 'jump to main' shortcut — but only if <main> exists. Without it, every page navigation forces re-reading the header. Wrap your primary content in a single <main>.
Source: WAI-ARIA / WCAG 2.4.1
Add a skip link as the first focusable element so keyboard users can bypass repeated navigation.
Without a skip-nav link, keyboard users tab through every nav item before reaching content — every page, every visit.
Learn more ▾ ▴
WCAG 2.4.1 (Bypass Blocks) requires a mechanism to skip past repeated content. The standard implementation is a 'Skip to main content' link that's the first focusable element, visually hidden until focused. Three lines of HTML + four of CSS.
Source: WCAG 2.1 SC 2.4.1
FAlt Text QualityAction4 of 5 images have issuesFIX
| Issue | Count |
|---|---|
| missing | 4 image(s) |
Images without alt text are invisible to screen readers.
Each image without alt text is a WCAG 1.1.1 failure — invisible to screen-reader users, lost from Google Image Search.
Learn more ▾ ▴
WCAG 2.1 Level A requires text alternatives for non-decorative images. Empty alt='' is fine for decorative; meaningful images need descriptive text. Common fixes: CMS audit + bulk add, build-time linter (alt-text-required ESLint rule), CI gate on Lighthouse a11y score.
Source: WCAG 2.1 SC 1.1.1 / WebAIM Million Report
An image inside a link with no alt creates an empty link.
Image-only links with no alt create empty links — screen-reader users hear 'link' with no destination context.
Learn more ▾ ▴
An <a><img></a> with no img alt is the worst-case for accessibility: AT announces the link but can't describe where it goes. Either add alt to the image OR add aria-label to the link.
Source: WCAG 2.1 SC 2.4.4
DLink & Button QualityAction4 issue(s) across 75 links and 0 buttonsFIX
| Element | Text | Issue | Suggested Fix |
|---|---|---|---|
| static/roundcube.png | (empty) | empty | Add link text or aria-label |
| static/nextcloud_contacts.png | (empty) | empty | Add link text or aria-label |
| static/control_panel.png | (empty) | empty | Add link text or aria-label |
| https://letsencrypt.org/repository/ | Let’s Encrypt Subscriber Agr… | new tab | Add '(opens in new tab)' to text |
| https://github.com/mail-in-a-box/mailina… | here | generic text | Replace with descriptive text |
Before: here Suggested: 2452#Issuecomment 2435044314 | |||
| https://twitter.com/shevski | @shevski | new tab | Add '(opens in new tab)' to text |
| https://github.com/konklone | @konklone | new tab | Add '(opens in new tab)' to text |
| https://github.com/gregelin | @GregElin | new tab | Add '(opens in new tab)' to text |
Links without text are announced as raw URLs by screen readers.
static/roundcube.png; static/nextcloud_contacts.png; static/control_panel.png
Links with no accessible text (empty <a></a>, image-only no alt, icon-only no aria-label) are unidentifiable to screen readers.
Source: WCAG 2.1 SC 2.4.4
Generic link text like 'click here' doesn't describe the destination.
https://github.com/mail-in-a-box/mailinabox/issues/2452#issuecomment-2435044314 ("here")
Generic anchor text ('click here', 'read more', 'learn more') tells screen readers and search engines nothing about the destination.
Learn more ▾ ▴
Out-of-context lists of links read by AT (one navigation pattern) become useless when every link says 'click here'. Use the destination's title or topic as anchor text. Doubles as SEO win — Google passes anchor-text relevance to the destination.
Source: WCAG 2.4.4 / Google Search Central
Add '(opens in new tab)' to link text or aria-label.
https://letsencrypt.org/repository/; https://twitter.com/shevski; https://github.com/konklone; https://github.com/gregelin
Links with target="_blank" without rel="noopener" leak the originating page's window context — security and UX issue.
Learn more ▾ ▴
Without rel="noopener", the new tab can navigate the original tab via window.opener (tab-nabbing attack). Modern browsers default to noopener for target=_blank but only since recent versions. Always set rel="noopener noreferrer" explicitly.
Source: MDN target / OWASP
F404 Error PageActionHTTP 404, bare pageFIX
FFavicon & BrandingAction2 icon(s) detectedFIX
DWeb ManifestActionNot foundFIX
No web manifest found.
DDark Mode SupportActionNo dark mode signalsFIX
Detection limited to meta tags and inline styles.
DPrint StylesheetActionNo print stylesFIX
DLighthouse Accessibility AuditsActionScore 59/100 — 6 failing, 8 passedFIX
Accessibility
These checks highlight opportunities to improve the accessibility of your web app. Automatic detection can only detect a subset of issues and does not guarantee the accessibility of your web app, so manual testing is also encouraged.
Contrast
Low-contrast text is difficult or impossible for many users to read. Learn how to provide sufficient color contrast.
Performance issues directly impact user engagement and conversion rates.
| Failing Elements |
|---|
setup guide div.row > div#sidebar > p > a |
discussion forum div.row > div#sidebar > p > a |
chat room div.row > div#sidebar > p > a |
maintenance guide div.row > div#sidebar > p > a |
advanced tips div.row > div#sidebar > p > a |
github repository div.row > div#sidebar > p > a |
@MailInABox@fosstodon.org div.row > div#sidebar > p > a |
@Mailinabox div.row > div#sidebar > p > a |
Code of Conduct div.row > div#sidebar > p > a |
These are opportunities to improve the legibility of your content.
Names and labels
Informative elements should aim for short, descriptive alternate text. Decorative elements can be ignored with an empty alt attribute. Learn more about the `alt` attribute.
Performance issues directly impact user engagement and conversion rates.
| Failing Elements |
|---|
div.container > header > div > img div.container > header > div > img |
div#screenshots > div.col-sm-4 > a > img.img-fluid div#screenshots > div.col-sm-4 > a > img.img-fluid |
div#screenshots > div.col-sm-4 > a > img.img-fluid div#screenshots > div.col-sm-4 > a > img.img-fluid |
div#screenshots > div.col-sm-4 > a > img.img-fluid div#screenshots > div.col-sm-4 > a > img.img-fluid |
Screen reader users rely on frame titles to describe the contents of frames. Learn more about frame titles.
Performance issues directly impact user engagement and conversion rates.
| Failing Elements |
|---|
div.row > div.col-sm-9 > div > iframe div.row > div.col-sm-9 > div > iframe |
Link text (and alternate text for images, when used as links) that is discernible, unique, and focusable improves the navigation experience for screen reader users. Learn how to make links accessible.
Performance issues directly impact user engagement and conversion rates.
| Failing Elements |
|---|
div.col-sm-9 > div#screenshots > div.col-sm-4 > a div.col-sm-9 > div#screenshots > div.col-sm-4 > a |
div.col-sm-9 > div#screenshots > div.col-sm-4 > a div.col-sm-9 > div#screenshots > div.col-sm-4 > a |
div.col-sm-9 > div#screenshots > div.col-sm-4 > a div.col-sm-9 > div#screenshots > div.col-sm-4 > a |
These are opportunities to improve the semantics of the controls in your application. This may enhance the experience for users of assistive technology, like a screen reader.
Internationalization and localization
If a page doesn't specify a `lang` attribute, a screen reader assumes that the page is in the default language that the user chose when setting up the screen reader. If the page isn't actually in the default language, then the screen reader might not announce the page's text correctly. Learn more about the `lang` attribute.
Performance issues directly impact user engagement and conversion rates.
| Failing Elements |
|---|
html.no-js html.no-js |
These are opportunities to improve the interpretation of your content by users in different locales.
Best practices
One main landmark helps screen reader users navigate a web page. Learn more about landmarks.
Performance issues directly impact user engagement and conversion rates.
| Failing Elements |
|---|
html.no-js html.no-js |
These items highlight common accessibility best practices.
CColor Contrast (Screenshot)Action20 text elements analyzed, 8 fail WCAG AAREVIEW
Analyzes text contrast against the actual rendered page, including background images, gradients, and overlays that CSS-based tools cannot detect.
Show all checked elements (20)
| Element | Ratio | Required | FG | BG | Result |
|---|---|---|---|---|---|
| h1 Mail | 21.00:1 | 3.0:1 | #000000 | #FFFFFF | Pass |
| h1 Box | 2.78:1 | 3.0:1 | #000000 | #AD0000 | Fail |
| h2 quick links | 21.00:1 | 3.0:1 | #000000 | #FFFFFF | Pass |
| h2 What is it? | 21.00:1 | 3.0:1 | #000000 | #FFFFFF | Pass |
| h2 Status | 1.02:1 | 3.0:1 | #000000 | #030302 | Fail |
| h2 What’s inside the … | 1.00:1 | 3.0:1 | #000000 | #010000 | Fail |
| h2 How do I get it? | 1.00:1 | 3.0:1 | #000000 | #010000 | Fail |
| h2 Why build this? | 1.00:1 | 3.0:1 | #000000 | #010000 | Fail |
| h2 Help | 1.00:1 | 3.0:1 | #000000 | #010000 | Fail |
| h2 Development | 1.00:1 | 3.0:1 | #000000 | #010000 | Fail |
| h2 Acknowledgements | 1.00:1 | 3.0:1 | #000000 | #010000 | Fail |
| title Mail-in-a-Box | 21.00:1 | 4.5:1 | #000000 | #FFFFFF | Pass |
| p Take back control of… | 21.00:1 | 4.5:1 | #000000 | #FFFFFF | Pass |
| a setup guide | 21.00:1 | 4.5:1 | #000000 | #FFFFFF | Pass |
| a discussion forum | 21.00:1 | 4.5:1 | #000000 | #FFFFFF | Pass |
| a chat room | 21.00:1 | 4.5:1 | #000000 | #FFFFFF | Pass |
| a maintenance guide | 21.00:1 | 4.5:1 | #000000 | #FFFFFF | Pass |
| a advanced tips | 21.00:1 | 4.5:1 | #000000 | #FFFFFF | Pass |
| a github repository | 21.00:1 | 4.5:1 | #000000 | #FFFFFF | Pass |
| a @MailInABox@fosstodo… | 21.00:1 | 4.5:1 | #000000 | #FFFFFF | Pass |
Methodology: The top 20 text elements by font size were checked. Background color was sampled from the desktop screenshot using a 5-point pattern. WCAG 2.1 AA requires 4.5:1 for normal text and 3:1 for large text.
A+Heading Hierarchy10 headingsPASS
- H1 Mail-in-a-Box
- H2 quick links
- H2 What is it?
- H2 Status
- H2 What’s inside the box?
- H2 How do I get it?
- H2 Why build this?
- H2 Help
- H2 Development
- H2 Acknowledgements