Context.contentLanguage property (JavaScript API for Office)

apps for Office

Gets the locale (language) specified by the user for editing the document or item.

Last modified: April 24, 2015

Hosts:

Access, Excel, PowerPoint, Project, Word

Last changed in

1.1

See all support details

var myContentLang = Office.context.contentLanguage;

A string in the RFC 1766 Language tag format, such as en-US.

The contentLanguage value reflects the Editing Language setting specified with File > Options > Language in the Office host application.

In content apps for Access web apps, the contentLanguage property gets the app culture (e.g., "en-GB").

function sayHelloWithContentLanguage() {
    var myContentLanguage = Office.context.contentLanguage;
    switch (myContentLanguage) {
        case 'en-US':
            write('Hello!');
            break;
        case 'en-NZ':
            write('G\'day mate!');
            break;
    }
}
// Function that writes to a div with id='message' on the page.
function write(message){
    document.getElementById('message').innerText += message; 
}

A checkmark (√) in the following matrix indicates that this method is supported in the corresponding Office host application. An empty cell indicates that the Office host application doesn't support this method.

For more information about Office host application and server requirements, see Requirements for running apps for Office.

Office for Windows desktop

Office for Windows RT

Office Online
(in browser)

Access

Excel

PowerPoint

Project

Word

Minimum permission level

Restricted

App types

Content, task pane

Library

Office.js

Namespace

Office

Version

Changes

1.1

Added access to this API in content apps for Access.

1.0

Introduced

Show:
© 2015 Microsoft