No semantic HTML
Part of Documentation, UX & Accessibility, which counts for 15% of the overall score. When this check fires it deducts 4 points from that category, once per scan, no matter how many places it turns up.
What it detects
The page is built entirely from generic <div> elements with no semantic HTML5 structure, hurting accessibility and SEO.
Why it matters
A page built entirely from <div> elements gives assistive technology no landmarks: a screen-reader user cannot jump to the navigation, the main content, or the footer, and has to walk the whole page linearly. Semantic tags also give search engines structure to work with. The fix is mostly renaming wrapper elements, so the cost is low.
How to fix it
Replace the structural wrapper divs with the matching HTML5 landmarks: <header> for the top banner, <nav> around primary navigation, one <main> for the page's core content, <footer> for the bottom, and <section> or <article> for major content blocks. Keep every class and id in place so styling is untouched, since these elements style exactly like divs by default. Leave purely presentational grouping divs alone.
The paid report includes a ready-to-paste prompt for your AI coding agent for every check it finds, pointed at the exact findings from your scan. See pricing
Does your repo trip this check?
Paste a GitHub URL or drop a project folder. Scans run in your browser and take seconds.
Scan your repo