How to fix html has lang on Shopify

Add a valid `lang` attribute to the `<html>` element so browsers, screen readers, and search engines know what language your page is written in.

Steps for Shopify

  1. In your Shopify admin, go to Online Store → Themes.
  2. Next to your active theme, click Actions → Edit code.
  3. In the left file list, under Layout, click theme.liquid (this is your site's master template).
  4. Find the opening `<html` tag near the top of the file.
  5. If it already contains `xml:lang`, replace it with `lang`. If neither exists, add `lang="{{ shop.locale }}"` — Shopify's Liquid variable that outputs the store's active locale code automatically.
  6. The result should look like: `<html lang="{{ shop.locale }}">` (or a hard-coded code like `lang="en"` if you only serve one language).
  7. Click Save. Verify by viewing your storefront source.
Official Shopify documentation ↗

What is html has lang?

Every HTML page should declare its primary language in the opening `<html>` tag using a `lang` attribute — for example, `<html lang="en">` for English. This single attribute tells browsers, screen readers, and search-engine crawlers what human language the page content is written in. WCAG Success Criterion 3.1.1 ("Language of Page") requires it. A common mistake is using the XML version (`xml:lang`) instead of the standard HTML `lang` attribute — only `lang` is valid in HTML documents.

Screen readers use the `lang` attribute to select the correct pronunciation engine and voice profile; without it, a visually-impaired customer may hear your entire site read aloud in the wrong language, making it effectively unusable. This is a Level A WCAG violation — the lowest bar for accessibility compliance — and is frequently cited in accessibility audits and legal complaints under the ADA, the European Accessibility Act, and equivalent laws worldwide, exposing you to real legal and financial risk. Search engines also use the declared language to serve your pages to the right audiences, so a missing or wrong `lang` value can quietly undermine your international SEO. Fixing it takes less than five minutes and has zero negative side effects.

See the complete Html has lang guide for every platform and the full background.

Not sure if your Shopify store has this?

Run a free SEOLZ scan — we’ll find html has lang and every other issue across your whole site.

Scan my site free

Fix html has lang on another platform