Skip to content
LingravelixMultilingual websites, planned properly

Tool

Locale QA checklist

Thirty-three checks to run before a multilingual site or a new language version goes live, grouped into language markup, navigation, search signals, text and layout, locale formats, forms and policies, and right-to-left pages. Tick them as you go, watch the progress bar, and save the result as a text file for your records. It records your own checks; it does not test anything automatically.

Locale QA checklist

With JavaScript off the boxes still tick, but the progress bar and the text export stay inactive. Printing the page works as a paper copy.

Language and markup
Navigation and switching
Search signals
Text and layout
Locale formats
Forms, email and policies
Right-to-left scripts, if used

Progress: 0 of 33 checks done

How to use it

Work through the list on the real site, in every language, ideally on a staging copy before release. A check counts as done when it holds for every language version, not just the first. Where a check does not apply, such as the right-to-left group on a site without Arabic or Hebrew, tick it with a note in your own records so the export does not look unfinished.

The export lists every check with [x] or [ ] in front of it and the name you gave the release, which makes it easy to attach to a ticket or a project log.

Where the checks come from

Language and markup

Declaring the language of each page is WCAG 2.2 success criterion 3.1.1 at Level A 1, and marking passages in another language is criterion 3.1.2 at Level AA 2. Google recommends a single language for the content and navigation of each page 3.

Navigation and switching

The switcher checks follow the principles in our switcher guide: languages named in themselves, no flags, lang and hreflang on options 4, and the same position on every page. The redirect check reflects Google's advice to avoid automatic redirection based on what you think a user's language may be 3.

Search signals

The hreflang checks restate Google's documentation: ISO codes, x-default as a fallback, and every version listing every other 5. Canonical tags staying within a language prevent conflicting signals.

Text and layout

Short strings expand the most when translated, according to the IBM figures the W3C cites 6, which is why buttons and menus get their own check.

Locale formats

Swiss consumer prices are shown in CHF with VAT included, as the Confederation's SME portal summarises 7. The other format checks follow our Swiss formats guide.

Right-to-left scripts

The direction checks follow the W3C advice to set dir="rtl" on the html element and not to set base direction with CSS 8.

What the checklist is not

It is not an automated audit and it does not prove compliance with any law or standard. A ticked box records that someone checked; it does not replace testing with real readers of each language, and it does not replace legal advice on what your site must publish.

When to use it

  • Before launching a new multilingual site.
  • Before switching on a new language in an existing site.
  • After a redesign or a change of theme, plugin or platform.
  • Once a year as a review, since content and templates drift.

Printing

The list prints cleanly from your browser if you prefer paper. The page's header, footer and contact band are hidden in print.

Sources

  1. WCAG 2.2 explainer for 3.1.1 (page language) W3C WAI, primary source
  2. WCAG 2.2 explainer for 3.1.2 (language of passages) W3C WAI, primary source
  3. Multi-regional and multilingual sites Google Search Central, primary source
  4. Language switcher specification specification.website (open reference, CC BY 4.0), secondary source
  5. Localized versions of a page (hreflang) Google Search Central, primary source
  6. Text size in translation W3C Internationalization Activity, primary source
  7. Price labelling rules SME portal of the Swiss Confederation, primary source
  8. Structural markup and right-to-left text W3C Internationalization Activity, primary source

Want someone else to run the checks?

Tell us the site and the languages being released. We reply by email to say whether we can do it.

Ask about a check