officeTheme.bodyForegroundColor property

Gets the Office theme body foreground color.

Important: This API currently works only in Excel, Outlook, PowerPoint, and Word in Office 2016 Preview on Windows desktop.

Hosts: Excel, Outlook, PowerPoint, Word
Available in Requirement set Not in a set
Added in 1.3
var bodyForegroundColor = Office.context.officeTheme.bodyForegroundColor;

Return value

A hex color triplet.


The colors returned correspond to the values of the Office theme selected by the user with File > Office Account > Office Theme UI, which is applied across all Office host applications.

Support details

A capital Y 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 Office Add-ins.

Supported hosts, by platform

Office for Windows desktop Office Online (in browser) Office for iPad OWA for Devices
Excel Y
Outlook Y
PowerPoint Y
Word Y
Minimum permission level Restricted
Add-in types Content, task pane, Outlook
Library Office.js
Namespace Office

Support history

Version Changes
1.3 Introduced