Context.officeTheme property

Provides access to the properties for Office theme colors.

Hosts: Excel, PowerPoint, Word
Available in Requirement set Not in a set
Added in 1.3



Name Description
bodyBackgroundColor Gets the Office theme body background color.
bodyForegroundColor Gets the Office theme body foreground color.
controlBackgroundColor Gets the Office theme control background color.
controlForegroundColor Gets the Office theme control foreground color.


Using Office theme colors let's you coordinate the color scheme of your add-in with the current Office theme selected by the user with File > Office Account > Office Theme UI, which is applied across all Office host applications.


function applyOfficeTheme(){
    // Get office theme colors.
    var bodyBackgroundColor = Office.context.officeTheme.bodyBackgroundColor;
    var bodyForegroundColor = Office.context.officeTheme.bodyForegroundColor;
    var controlBackgroundColor = Office.context.officeTheme.controlBackgroundColor
    var controlForegroundColor = Office.context.officeTheme.controlForegroundColor;

    // Apply body background color to a CSS class.
    $('.body').css('background-color', bodyBackgroundColor);

Support details

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

Support history

Version Changes
1.3 Introduced
th> 1.3 Introduced