• Success Criterion 3.1.1
  • Conformance level A

3.1.1 · Language of Page

Lesson overview · Language of Page

In plain language

The page's language must be declared in code (lang attribute) and be correct.

Who it affects

Screen-reader users who need correct pronunciation, and tools that depend on language metadata.

How to check

View source: <html lang='..'> must exist and match the page language — including after switching site language. Worked example — A hospital's patient portal appointment scheduler: switch the site's UI language and check document.documentElement.lang in DevTools console: if it doesn't update to match, it fails.

Common misconception

Setting lang="en" once in the template feels like a one-time task. It breaks the moment a site adds a language switcher and forgets to update the attribute when the user changes languages. Real example: on a music streaming app's playlist screen, the playlist screen's HTML omits a lang attribute entirely, so assistive technology has no way to know the page's content is in English and can't pick the correct pronunciation rules.

Learn more

get in touch

Know where you stand. Know what to work on next.

Tell us what you’re working on and where you need support. Our accessibility specialists can help with audits, remediation, VPAT/ACR, accessible development, and ongoing compliance.

Book a 30-minute consultation (opens in new tab)

Let’s find the barriers before your users do

Indicates a required field.


Your information is kept private and never shared with third parties.

Scenarios in this lesson