Skip to main content

spo theme set

Add or update a theme

Usage​

m365 spo theme set [options]

Options​

-n, --name <name>

Name of the theme to add or update

-t, --theme <theme>

Theme JSON contents

--isInverted

Set to specify that the theme is inverted

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is full.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

To prevent the accidental creation of invalid themes the CLI for Microsoft 365 implements a set of checks. These checks are executed against the provided json file. A valid theme JSON file is as follows:

{
  "themePrimary": "#d81e05",
  "themeLighterAlt": "#fdf5f4",
  "themeLighter": "#f9d6d2",
  "themeLight": "#f4b4ac",
  "themeTertiary": "#e87060",
  "themeSecondary": "#dd351e",
  "themeDarkAlt": "#c31a04",
  "themeDark": "#a51603",
  "themeDarker": "#791002",
  "neutralLighterAlt": "#eeeeee",
  "neutralLighter": "#f5f5f5",
  "neutralLight": "#e1e1e1",
  "neutralQuaternaryAlt": "#d1d1d1",
  "neutralQuaternary": "#c8c8c8",
  "neutralTertiaryAlt": "#c0c0c0",
  "neutralTertiary": "#c2c2c2",
  "neutralSecondary": "#858585",
  "neutralPrimaryAlt": "#4b4b4b",
  "neutralPrimary": "#333333",
  "neutralDark": "#272727",
  "black": "#1d1d1d",
  "white": "#f5f5f5"
}

When executing the m365 spo theme set command the following checks are executed:

  • Validate if the provided theme is a valid JSON string.
  • Validate if the provided theme, once deserialized, contains all properties of the sample above.
  • Validate if the provided theme, once deserialized, contains only the properties of the sample above.
  • Validate if each of the properties contains a valid hex color value prefixed with a #.

If any of these checks fails you are presented with a The specified theme is not valid error.

info

To use this command you have to have permissions to access the tenant admin site.

Examples​

Add or update a theme from a theme JSON file

m365 spo theme set --name Contoso-Blue --theme @/Users/rjesh/themes/contoso-blue.json

Add or update an inverted theme from a theme JSON file

m365 spo theme set --name Contoso-Blue --theme @/Users/rjesh/themes/contoso-blue.json --isInverted

More information​

CTRL + M