Skip to content
https://astro.build

Accessibility

· 13 checks — Landmarks, headings, alt text, forms, and link quality rolled into one auditable list.
SCORE
62
GRADE
D
FIX
6
REVIEW
2
PASS
5
INFO
0
Checks
13
5 PASS 2 REVIEW 6 FIX
F
Favicon & Branding
Action
1 icon(s) detected
FIX
1 icon(s) detected
Warning::
No favicon.ico at site root
Some older browsers, bookmark tools, and RSS readers look for /favicon.ico. Add one as a fallback.
Info::
HTML icon links detected
Info::
No apple-touch-icon detected
iOS devices use this when users add your site to their home screen. Add <link rel='apple-touch-icon' sizes='180x180' href='/apple-touch-icon.png'>.
Info::
SVG favicon detected — scales perfectly to any size
✗ favicon.ico Missing
✓ PNG Icons Present
✗ Apple Touch Missing
✓ SVG Favicon Present
✗ Manifest Icons Missing
✗ Multiple Sizes Missing
D
Web Manifest
Action
Not found
FIX
Not found
Info::
No web manifest found
No manifest at standard paths (/manifest.json, /site.webmanifest). A manifest is optional but enables PWA features like home screen installation and standalone display.

No web manifest found.

D
Dark Mode Support
Action
Theme color only
FIX
Theme color only
Info::
Theme-color present but no dark variant
A theme-color is set but no dark-specific variant was found. The browser toolbar may not adapt for dark mode users.
Got: #8d46e7
Info::
No dark mode signals detected
Consider adding CSS with @media (prefers-color-scheme: dark) and <meta name='color-scheme' content='light dark'>.
Info::
Detection limited to meta tags and inline styles
External CSS files may contain prefers-color-scheme rules not visible to this scan.
Dark ModePartial Dark Mode
color-scheme meta Not set ✗Dark theme-color Not set ✗CSS indicators Not detected ✗

Detection limited to meta tags and inline styles.

D
Print Stylesheet
Action
No print styles
FIX
No print styles
Info::
No print-specific styles detected
When users print this page, they get the screen layout including navigation and non-essential elements. Add @media print rules to hide navigation and optimize layout for paper.
Print Stylesheet No Print Styles
Print stylesheet Not found ✗Inline @media print Not detected ✗
F
Navigation UX
Action
1 navigation pattern(s)
FIX
1 navigation pattern(s)
Info::
Skip navigation link detected
Info::
5 navigation landmark(s) detected
Breadcrumbs
Search
Skip Link Skip link detected
Labeled Navigation 5 <nav> element(s)
Back to Top
Hamburger Menu
Sticky Navigation Cannot reliably detect (CSS-based)
2 of 6 testable patterns navigation patterns detected. Limited navigation support. Consider adding breadcrumbs, search, and skip link.
B
404 Error Page
HTTP 404, custom page
REVIEW
HTTP 404, custom page
Info::
Correct 404 status code returned
Got: HTTP 404
Info::
Custom styled 404 page
Info::
Navigation links present on 404 page
Info::
Homepage link present on 404 page
404 Page Quality ✓ Custom 404 Page
Status Code HTTP 404 ✓Page Title Page not found | Astro ✓Custom Styling ✓Navigation ✓Homepage Link ✓Search Form ✗
C
Color Contrast (Screenshot)
Action
20 text elements analyzed, 20 fail WCAG AA
REVIEW

Analyzes text contrast against the actual rendered page, including background images, gradients, and overlays that CSS-based tools cannot detect.

0 pass 20 fail WCAG AA
h1 The web framework for content-driven web…
1.45:1
#000000
on
#33126E
needs 3.0:1 (large text)
32px · bottom of viewport
h2 is a JavaScript web framework optimized …
1.45:1
#000000
on
#33126E
needs 3.0:1 (large text)
24px · bottom of viewport
h2 Server-First
1.45:1
#000000
on
#33126E
needs 3.0:1 (large text)
24px · bottom of viewport
h2 Content-Driven
1.45:1
#000000
on
#33126E
needs 3.0:1 (large text)
24px · bottom of viewport
h2 Customizable
1.45:1
#000000
on
#33126E
needs 3.0:1 (large text)
24px · bottom of viewport
h2 Snapback Cap
1.45:1
#000000
on
#33126E
needs 3.0:1 (large text)
24px · bottom of viewport
h2 Start building with
1.45:1
#000000
on
#33126E
needs 3.0:1 (large text)
24px · bottom of viewport
h2 Astro today
1.45:1
#000000
on
#33126E
needs 3.0:1 (large text)
24px · bottom of viewport
h2 Astro is free, open-source software made…
1.45:1
#000000
on
#33126E
needs 3.0:1 (large text)
24px · bottom of viewport
h2 Resources
1.45:1
#000000
on
#33126E
needs 3.0:1 (large text)
24px · bottom of viewport
h2 About
1.45:1
#000000
on
#33126E
needs 3.0:1 (large text)
24px · bottom of viewport
h2 Community
1.45:1
#000000
on
#33126E
needs 3.0:1 (large text)
24px · bottom of viewport
h2 Legal
1.45:1
#000000
on
#33126E
needs 3.0:1 (large text)
24px · bottom of viewport
title Astro
1.43:1
#000000
on
#331466
needs 4.5:1 (normal text)
16px · top of page (header area)
a Skip to content
1.42:1
#000000
on
#321365
needs 4.5:1 (normal text)
16px · top of page (header area)
span Astro Logo
1.50:1
#000000
on
#371470
needs 4.5:1 (normal text)
16px · top of page (header area)
a Documentation
1.64:1
#000000
on
#3F1483
needs 4.5:1 (normal text)
16px · top of page (header area)
a Blog
1.63:1
#000000
on
#3F1482
needs 4.5:1 (normal text)
16px · above the fold
summary Resources
1.63:1
#000000
on
#3F1482
needs 4.5:1 (normal text)
16px · above the fold
a Themes
1.66:1
#000000
on
#401584
needs 4.5:1 (normal text)
16px · above the fold
Show all checked elements (20)
ElementRatioRequiredFGBGResult
h1 The web framework fo…1.45:13.0:1
#000000
#33126E
Fail
h2 is a JavaScript web …1.45:13.0:1
#000000
#33126E
Fail
h2 Server-First1.45:13.0:1
#000000
#33126E
Fail
h2 Content-Driven1.45:13.0:1
#000000
#33126E
Fail
h2 Customizable1.45:13.0:1
#000000
#33126E
Fail
h2 Snapback Cap1.45:13.0:1
#000000
#33126E
Fail
h2 Start building with1.45:13.0:1
#000000
#33126E
Fail
h2 Astro today1.45:13.0:1
#000000
#33126E
Fail
h2 Astro is free, open-…1.45:13.0:1
#000000
#33126E
Fail
h2 Resources1.45:13.0:1
#000000
#33126E
Fail
h2 About1.45:13.0:1
#000000
#33126E
Fail
h2 Community1.45:13.0:1
#000000
#33126E
Fail
h2 Legal1.45:13.0:1
#000000
#33126E
Fail
title Astro1.43:14.5:1
#000000
#331466
Fail
a Skip to content1.42:14.5:1
#000000
#321365
Fail
span Astro Logo1.50:14.5:1
#000000
#371470
Fail
a Documentation1.64:14.5:1
#000000
#3F1483
Fail
a Blog1.63:14.5:1
#000000
#3F1482
Fail
summary Resources1.63:14.5:1
#000000
#3F1482
Fail
a Themes1.66:14.5:1
#000000
#401584
Fail

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
Landmark Structure
8 landmarks
PASS
8 landmarks
Info::
<main> landmark present
Info::
5 <nav> landmark(s) found
Warning::
1 of 5 <nav> elements are unlabeled
Multiple navigations need aria-label to distinguish them for screen readers.
Info::
Skip navigation link present
Page Structure — as a screen reader sees it
BANNER header NAV "Primary" MAIN CONTENTINFO footer

Multiple navigations need aria-label to distinguish them for screen readers.

Why this matters

Some <nav> elements lack aria-label — screen-reader users hear 'navigation' multiple times with no way to distinguish them.

Learn more ▾

When a page has multiple <nav> regions (primary, footer, breadcrumb), each needs aria-label or aria-labelledby. AT users navigate by landmark; identical 'navigation' announcements force them to enter each one to discover purpose.

Source: WAI-ARIA Authoring Practices

A+
Heading Hierarchy
31 headings
PASS
31 headings
Info::
Single H1 present
  • H1 The web framework for content-driven websites
  • H2 Astro is a JavaScript web framework optimized for building fast, content-driven websites.
  • H2 Server-First
  • H2 Content-Driven
  • H2 Customizable
  • H2 Astro Islands
  • H2 Zero Lock-in
  • H2 Snapback Cap
  • H2 Fully Featured
  • H3 Content Collections
  • H3 Zero JavaScript, By Default
  • H3 View Transitions
  • H3 Optimized Images
  • H3 UI Integrations
  • H3 File-Based Routing
  • H3 Middleware
  • H3 Actions
  • H3 Deployment Adapters
  • H3 Simple Templating
  • H3 Instant Page Loads
  • H3 AI-Ready
  • H3 Environment Variables
  • H3 Dev Toolbar
  • H2 Themes
  • H2 Get professional Astro support
  • H2 Start building with Astro today
  • H2 Astro is free, open-source software made possible by these wonderful sponsors
  • H2 Resources
  • H2 About
  • H2 Community
  • H2 Legal
A+
Alt Text Quality
All 43 images OK
PASS
All 43 images OK
Info::
10 decorative image(s) correctly marked
Info::
33 image(s) with good alt text
43 images 33 good alt text 10 decorative
All images have appropriate alt text.
A
Form Accessibility
1 of 2 controls have issues
PASS
1 of 2 controls have issues
Critical::
1 control(s) without accessible label
Form controls need a <label>, aria-label, or aria-labelledby for screen readers.
Got: <input type="submit">
Info::
1 control(s) properly labeled
2 controls
1 labeled
0 placeholder only
1 unlabeled
ControlTypeLabelMethod
#bd-emailemailEmailfor/id
inputsubmit(none)none

Form controls need a <label>, aria-label, or aria-labelledby for screen readers.

<input type="submit">

Why this matters

Form controls without labels — assistive tech announces 'edit text' with no context; users can't complete forms.

Source: WCAG 2.1 SC 3.3.2

A+
Lighthouse Accessibility Audits
Score 100/100 — 0 failing, 30 passed
PASS
100

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.

○Interactive controls are keyboard focusable
○Interactive elements indicate their purpose and state
○The page has a logical tab order
○Visual order on the page follows DOM order
○User focus is not accidentally trapped in a region
○The user's focus is directed to new content added to the page
○HTML5 landmark elements are used to improve navigation
○Offscreen content is hidden from assistive technology
○Custom controls have associated labels
○Custom controls have ARIA roles
●`[aria-*]` attributes match their roles
●`[aria-hidden="true"]` is not present on the document `<body>`
●`[role]`s have all required `[aria-*]` attributes
●Elements with an ARIA `[role]` that require children to contain a specific `[role]` have all required children.
●`[role]`s are contained by their required parent element
●`[role]` values are valid
●`[aria-*]` attributes have valid values
●`[aria-*]` attributes are valid and not misspelled
●Buttons have an accessible name
●Image elements have `[alt]` attributes
●Input buttons have discernible text.
●Form elements have associated labels
●`[user-scalable="no"]` is not used in the `<meta name="viewport">` element and the `[maximum-scale]` attribute is not less than 5.
●ARIA attributes are used as specified for the element's role
●`[aria-hidden="true"]` elements do not contain focusable descendents
●Elements use only permitted ARIA attributes
●Background and foreground colors have a sufficient contrast ratio
●Document has a `<title>` element
●`<html>` element has a `[lang]` attribute
●`<html>` element has a valid value for its `[lang]` attribute
●Links are distinguishable without relying on color.
●Links have a discernible name
●Lists contain only `<li>` elements and script supporting elements (`<script>` and `<template>`).
●List items (`<li>`) are contained within `<ul>`, `<ol>` or `<menu>` parent elements
●No element has a `[tabindex]` value greater than 0
●Touch targets have sufficient size and spacing.
●Heading elements appear in a sequentially-descending order
●Skip links are focusable.
●Document has a main landmark.
●Deprecated ARIA roles were not used
○`[accesskey]` values are unique
○`button`, `link`, and `menuitem` elements have accessible names
○Elements with `role="dialog"` or `role="alertdialog"` have accessible names.
○ARIA input fields have accessible names
○ARIA `meter` elements have accessible names
○ARIA `progressbar` elements have accessible names
○Elements with the `role=text` attribute do not have focusable descendents.
○ARIA toggle fields have accessible names
○ARIA `tooltip` elements have accessible names
○ARIA `treeitem` elements have accessible names
○The page contains a heading, skip link, or landmark region
○`<dl>`'s contain only properly-ordered `<dt>` and `<dd>` groups, `<script>`, `<template>` or `<div>` elements.
○Definition list items are wrapped in `<dl>` elements
○ARIA IDs are unique
○No form fields have multiple labels
○`<frame>` or `<iframe>` elements have a title
○`<html>` element has an `[xml:lang]` attribute with the same base language as the `[lang]` attribute.
○`<input type="image">` elements have `[alt]` text
○The document does not use `<meta http-equiv="refresh">`
○`<object>` elements have alternate text
○Select elements have associated label elements.
○Cells in a `<table>` element that use the `[headers]` attribute refer to table cells within the same table.
○`<th>` elements and elements with `[role="columnheader"/"rowheader"]` have data cells they describe.
○`[lang]` attributes have a valid value
○`<video>` elements contain a `<track>` element with `[kind="captions"]`
○Tables have different content in the summary attribute and `<caption>`.
○All heading elements contain content.
○Uses ARIA roles only on compatible elements
○Image elements do not have `[alt]` attributes that are redundant text.
○Identical links have the same purpose.
○Elements with visible text labels have matching accessible names.
○Tables use `<caption>` instead of cells with the `[colspan]` attribute to indicate a caption.
○`<td>` elements in a large `<table>` have one or more table headers.
All checks on this page are automated. Results are estimates - run targeted manual reviews when the score affects a release decision.

Send Feedback