Chrome's Language Detection API: Identify User Languages On-Device, For Free

Your extension has users worldwide — but do you know what language they’re typing in? Chrome 138 introduces the Chrome Language Detection API, a built-in AI model that identifies text language instantly, on-device, with zero data leaving the browser.

Pair it with the Chrome Translator API and you get a complete, free, private translation pipeline — no third-party services required.

Why Extension Developers Need Language Detection

Without language detection, your extension is guessing. Common problems:

• Wrong translation direction — translating Spanish text as if it’s English
• Broken locale logic — assuming navigator.language matches what users actually type
• Expensive API calls — paying Google or AWS just to identify a language before translating
• Privacy violations — sending user text to external detection services

The Chrome Language Detection API solves all of these locally. One API call. Zero network traffic. Ranked results with confidence scores.

Quick Start: Detect Language in 3 Steps

1. Check Availability

if ('LanguageDetector' in self) {
  // Chrome 138+ with Language Detection support
}

2. Create a Detector

const detector = await LanguageDetector.create();

3. Detect Language

const results = await detector.detect('Bonjour le monde!');
console.log(results[0]);
// { detectedLanguage: 'fr', confidence: 0.97 }

That’s it. The API returns a ranked array of language candidates with confidence scores (0.0–1.0), not just a single guess.

Confidence Scores: Make Smarter Decisions

Unlike binary detection APIs, the Chrome Language Detection API gives you probabilities. Use them:

const results = await detector.detect(userInput);
const topResult = results[0];

if (topResult.confidence > 0.8) {
  // High confidence — auto-translate
  translateTo(topResult.detectedLanguage);
} else if (topResult.confidence > 0.5) {
  // Medium confidence — ask user to confirm
  showLanguagePicker(results.slice(0, 3));
} else {
  // Low confidence — let user choose manually
  showFullLanguageSelector();
}

This pattern gives users a smooth experience regardless of detection accuracy.

Pair with the Translator API for Full Translation

The Chrome Language Detection API and Translator API are designed to work together. Detect first, then translate:

async function autoTranslate(text, targetLang) {
  const detector = await LanguageDetector.create();
  const [{ detectedLanguage, confidence }] = await detector.detect(text);

  if (confidence < 0.5) return null; // Too uncertain

  const translator = await Translator.create({
    sourceLanguage: detectedLanguage,
    targetLanguage: targetLang,
  });

  return translator.translate(text);
}

No external API. No billing. No privacy policy updates. Everything runs in the browser.

Real Extension Use Cases

Handling the Model Download

The AI model needs to download before first use. Handle it gracefully:

const detector = await LanguageDetector.create({
  monitor(m) {
    m.addEventListener('downloadprogress', (e) => {
      console.log(`Model download: ${Math.round(e.loaded * 100)}%`);
    });
  },
});

Check availability before showing detection UI:

const availability = await LanguageDetector.availability();
// 'available', 'downloadable', or 'unavailable'

Requirements and Limitations

• Chrome 138+ desktop only (Windows, macOS, Linux, ChromeOS)
• Hardware: 4GB+ VRAM (GPU) or 16GB+ RAM with 4+ CPU cores
• Short text accuracy: Single words or very short phrases may produce low-confidence results — always check the confidence score
• No mobile support yet

Graceful Fallback

async function detectLanguage(text) {
  if ('LanguageDetector' in self) {
    const availability = await LanguageDetector.availability();
    if (availability !== 'unavailable') {
      const detector = await LanguageDetector.create();
      const results = await detector.detect(text);
      return results[0]?.detectedLanguage;
    }
  }
  // Fallback to your existing detection method
  return fallbackDetect(text);
}

Why This Matters for Your Extension’s Growth

Extensions that understand their users’ languages have a measurable edge:

• Smarter UX — auto-adapt interface based on what users actually type, not browser locale
• Higher retention — users stay when the extension “just works” in their language
• Better reviews — fewer complaints about wrong-language behavior
• Zero marginal cost — detection runs on-device, scales infinitely

The Chrome Language Detection API is free, private, and built into the browser. There’s no reason not to use it.

What’s Next

Language Detection is part of Chrome’s Built-in AI suite, standardized through the W3C. Combined with the Chrome Translator API, extension developers now have a complete on-device language toolkit.

Ready to build multilingual extensions? Learn Chrome extension development fundamentals or optimize your Chrome Web Store listing to reach a global audience.

Grow Your Extension with AppBooster

Building a great extension is step one. Getting discovered is step two. AppBooster helps Chrome extension developers grow through peer reviews, visibility tools, and a community of builders. Get started free →