We're looking for a person or people to help audit MDN to find places we could speed up. Is this you or someone you know? Check out the RFP: https://mzl.la/2IHcMiE

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The NavigatorLanguage.languages read-only property returns an array of DOMStrings representing the user's preferred languages. The language is described using BCP 47 language tags. In the returned array they are ordered by preference with the most preferred language first.

The value of navigator.language is the first element of the returned array [3]. (But it refers to the system language setting.)

When its value changes, as the user's preferred languages are changed a languagechange event is fired on the Window object.

The Accept-Language HTTP header in every HTTP request from the user's browser uses the same value for the navigator.languages property except for the extra qvalues (quality values) field (e.g. en-US;q=0.8).


preferredLanguages = globalObj.navigator.languages


navigator.language   //"en-US"
navigator.languages  //["en-US", "zh-CN", "ja-JP"]


Specification Status Comment
HTML 5.1
The definition of 'NavigatorLanguage.languages' in that specification.
Recommendation Initial definition.

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Firefox (Gecko) Edge Internet Explorer Opera Safari
Basic support 32 [3] 32 (32) [1] preview [4] No support 24 [5] 11.0 [2]
on Web workers ? 35 (35) ? No support ? ?
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support No support 32.0 (32)[1] No support No support No support
on Web workers ? 35.0 (35) ? ? ?

[1] In Firefox, the navigator.languages property's value is taken from the intl.accept_languages preference.
[2] implemented in Safari Technology Preview 16 (10.2): Bug 163220 ; Release Notes
[3] In Chrome, navigator.language is the language of the browser UI, and is not guaranteed to be equal to navigator.languages[0].
[4] Will ship in Windows 10 Fall Creators Update: uservoice
[5] Opera 24 release notes

See also

Document Tags and Contributors

 Contributors to this page: jakub-g, mayank23, denghuiquan, teoli, chrisdavidmills, jt3rd, yisi, ziyunfei
 Last updated by: jakub-g,