Context object

Represents the runtime environment of the add-in and provides access to key objects of the API.

Hosts: Access, Excel, Outlook, PowerPoint, Project, Word
Last changed in 1.1


Member Type Description
auth Auth object Provides information and access to the signed-in user.
commerceAllowed bool Returns True if developers can display sell or upgrade UI in the add-in on that platform; otherwise returns False.
contentLanguage string Gets the locale (language) specified by the user for editing the document or item.
displayLanguage string Gets the locale (language) specified by the user for the UI of the Office host application.
document Document object Gets an object that represents the document the content or task pane add-in is interacting with.
host string Contains the host in which the add-in (web application) is running in. Possible values are: Word, Excel, PowerPoint
officeTheme OfficeTheme object Provides access to the properties for Office theme colors.
platform string Provides the platform on which the add-in is running. Possible values are: PC, OfficeOnline, Mac, iOS, Android, Universal
requirements object Offers requirements.isSetSupported() method to check if the specified requirement set is supported by the host Office application.
isSetSupported(name: string, minVersion?: number): boolean;
@param name - Set name. e.g.: "MatrixBindings".
roamingSettings RoamingSettings object Gets an object that represents the saved custom settings of the add-in.
touchEnabled bool Gets whether the add-in is running in an Office host application that is touch enabled.
ui Ui object Provides objects and methods that you can use to create and manipulate UI components, such as dialog boxes.


The Context object provides access to key objects in the JavaScript API for Office.

Support details

Minimum permission level Restricted
Add-in types Content, task pane, Outlook
Library Office.js
Namespace Office

Support history

Version Changes
1.1 Added Android and Universal as possible values for the platform property.
1.1 Added commerceAllowed and touchEnabledAdded properties (Excel, PowerPoint and Word on Office for iPad only).
1.1 Added support for add-ins with Excel and Word on Office for iPad.
1.1 For contentLanguage, displayLanguage, and document, added support for content add-ins for Access.
1.0 Introduced
Content End -->