Color Themes

Color themes define the CI/CD color palette that is made available to users in Microsoft Office via the primedocs ribbon. They are configured per organizational unit and inherited by all child OUs.

If multiple color themes are defined, users can switch between them in the Office ribbon (e.g. to toggle between a standard and a reduced color version).

Configuration

Color themes are stored as XML in the Color Theme field of the organizational unit. Under <ColorThemes>, you can define one or more <ColorTheme> elements.

Example

<ColorThemes>
  <ColorTheme Id="Standard" translate-DisplayName="ColorThemes.Standard" IsDefault="true">
    <Dark1>000000</Dark1>
    <Light1>FFFFFF</Light1>
    <Dark2>44546A</Dark2>
    <Light2>E7E6E6</Light2>
    <Accent1>4472C4</Accent1>
    <Accent2>ED7D31</Accent2>
    <Accent3>A5A5A5</Accent3>
    <Accent4>FFC000</Accent4>
    <Accent5>5B9BD5</Accent5>
    <Accent6>70AD47</Accent6>
    <Hyperlink>0563C1</Hyperlink>
    <FollowedHyperlink>954F72</FollowedHyperlink>
    <Chart>
      <ChartColors>
        <ChartColor translate-DisplayName="Colors.DeepBlue" Id="1">183F5A</ChartColor>
        <ChartColor translate-DisplayName="Colors.VividBlue" Id="2">007AC0</ChartColor>
        <ChartColor translate-DisplayName="Colors.DeepTeal" Id="3">006667</ChartColor>
        <ChartColor translate-DisplayName="Colors.VividTeal" Id="4">00AFBB</ChartColor>
      </ChartColors>
      <GridLinesColor translate-DisplayName="Colors.MediumGrey">A6A6A6</GridLinesColor>
      <GridAxisColor translate-DisplayName="Colors.Black">000000</GridAxisColor>
      <DataLabelColor translate-DisplayName="Colors.Black">000000</DataLabelColor>
      <TextColor translate-DisplayName="Colors.Black">000000</TextColor>
      <Font Name="Calibri Light" Size="14" Bold="false" Italic="false" />
      <TitleFont Name="Calibri Light" Size="14" Bold="true" Italic="false" />
      <GridLinesFormat DashStyle="msoLineSolid" Width="0.75" ColorHex="000000" />
    </Chart>
  </ColorTheme>
  <ColorTheme Id="Reduced" translate-DisplayName="ColorThemes.Reduced">
    <Dark1>000000</Dark1>
    <Light1>FFFFFF</Light1>
    <Dark2>44546A</Dark2>
    <Light2>E7E6E6</Light2>
    <Accent1>1F497D</Accent1>
    <Accent2>4F81BD</Accent2>
    <Accent3>9BBB59</Accent3>
    <Accent4>8064A2</Accent4>
    <Accent5>4BACC6</Accent5>
    <Accent6>F79646</Accent6>
    <Hyperlink>0563C1</Hyperlink>
    <FollowedHyperlink>954F72</FollowedHyperlink>
  </ColorTheme>
</ColorThemes>

Attributes

<ColorTheme>

Attribute	Description
Id	Unique identifier for this color theme.
translate-DisplayName	Translation key for the theme name shown to users. Alternatively use DisplayName for a plain string.
IsDefault	If true, this theme is selected by default. Only one theme should be marked as default.

Color elements

All color values are 6-digit hex codes without a leading #.

Element	Description
Dark1	Primary dark color (typically black).
Light1	Primary light color (typically white).
Dark2	Secondary dark color.
Light2	Secondary light color.
Accent1 – Accent6	The six Office accent colors.
Hyperlink	Color for hyperlinks.
FollowedHyperlink	Color for visited hyperlinks.

<PowerPointSpecific> (optional)

Override Dark1 and Light1 for PowerPoint only:

<PowerPointSpecific>
  <Dark1>363232</Dark1>
  <Light1>DBDBDB</Light1>
</PowerPointSpecific>

<Chart> (optional)

Defines the color palette and typography used in Office charts.

Element	Description
<ChartColors>	List of <ChartColor> elements, each with an Id (1-based) and a hex color.
<GridLinesColor>	Color of chart grid lines.
<GridAxisColor>	Color of chart axes.
<DataLabelColor>	Color of data labels.
<TextColor>	Default text color for chart elements.
<Font>	Default chart font (Name, Size, Bold, Italic).
<TitleFont>	Chart title font.
<GridLinesFormat>	Grid line style (DashStyle, Width, ColorHex).

Multilingual Display Names

Use translate-DisplayName together with a key from the Global Translations to show localized theme names in the ribbon:

<ColorTheme Id="Standard" translate-DisplayName="ColorThemes.Standard" IsDefault="true">

Inheritance

If no color theme is configured on an OU, the configuration from the nearest parent OU that has one is used. To override the parent, simply define a <ColorThemes> element on the child OU.