Admin setup

For Google Workspace administrators. This page puts Custom Color Palette for Google Workspace Docs, Sheets & Slides in your staff's Chrome with your colors already in the picker. It takes about ten minutes, all of it in the Google Admin console. There is no server to host and nothing to run.

Before you start

1. Build the settings text

If you have the extension installed, open its settings page, scroll to Administrators, and click Build organization palette. Pick your colors, choose one palette or several named ones, leave Staff cannot change these colors ticked, and click Copy. The builder warns you about a missing name or a bad hex code before you copy. If you opened it from the extension's settings, Start from my palettes brings in the palettes you have already built in that browser, so nothing is retyped.

Not installing the extension yourself? Email [email protected] and we will send the builder as files you open in Chrome. It works the same way and needs no internet connection.

To write the text by hand instead, edit one of these examples. One palette, up to 24 colors:

{
  "palette": {
    "Value": [
      { "name": "Primary",   "hex": "#1A73E8" },
      { "name": "Accent",    "hex": "#FE5917" },
      { "name": "Dark",      "hex": "#1A2D27" }
    ]
  },
  "paletteLocked": { "Value": true }
}

Several named palettes, up to 12, each with up to 24 colors. Staff start on the first one. If you set both, palettes is used. palette only applies if no palette in palettes is usable:

{
  "palettes": {
    "Value": [
      { "name": "Retail", "swatches": [
        { "name": "Primary", "hex": "#1A73E8" },
        { "name": "Accent",  "hex": "#FE5917" }
      ] },
      { "name": "Wholesale", "swatches": [
        { "name": "Primary", "hex": "#1A2D27" },
        { "name": "Accent",  "hex": "#9BDCD7" }
      ] }
    ]
  },
  "paletteLocked": { "Value": true }
}

Mistakes in hand-written text are skipped without any message. A color with no name or a bad hex code is dropped. A palette in palettes with no name is dropped, and so is a palette left with no colors. Colors after the 24th in a palette and palettes after the 12th are dropped. A color name longer than 48 characters, or a palette name longer than 40, is cut to that length. paletteLocked without a palette does nothing. Step 4 shows how to check what arrived.

paletteLocked keeps your palette intact: staff cannot edit it, and everyone is switched onto it once when the lock arrives. Staff can still make palettes of their own and choose them instead. Leave it out if you want your colors to be a starting point rather than a rule.

2. Add the extension in the Admin console

  1. Sign in at admin.google.com and go to Devices, Chrome, Apps & extensions, Users & browsers.
  2. Select the organizational unit in the left-hand list.
  3. Click the yellow + button at the bottom right, choose Add from Chrome Web Store, search for Custom Color Palette, click the extension, then click Select. A new organization's list starts empty; the extension does not appear just because someone installed it.
  4. Do not use Add Chrome app or extension by ID. That option is for extensions a company hosts itself and asks for an installation URL you do not have.
  5. Open the extension's row and check the ID under its name reads hchpnnppgakgmobkbldgkohmplkcahjl. Settings are delivered per ID, so any other ID silently configures nothing.

3. Force install and paste the settings

  1. On the same panel, set the installation policy to Force install. It puts the extension in Chrome for everyone in the unit who is signed in to Chrome with their work account. Allow install also works if you would rather staff add it themselves; your colors reach them once they install it.
  2. Scroll to Policy for extensions, select everything in the box, and paste your settings text over it.
  3. Click Save, in the upper right of the settings panel. It is not beside the box you edited, and nothing takes effect until you click it.
  4. The box stays yellow after saving. That means “set for this unit”, not “unsaved”. To be sure the save stuck, reload the console page and check your text is still there.

4. Confirm it arrived

On a staff member's managed browser, open chrome://policy and click Reload policies. The extension's section should show status OK and source Cloud. Delivery can take a minute or two. If it is still missing, check in this order: the ID on the console entry, that the browser is signed in to an account in that unit, and that the save stuck.

Once it arrives, the next color picker staff open in Docs, Sheets, or Slides shows your colors. No restart is needed, and later changes in the console reach them the same way, except anyone who has edited an unlocked palette (see below).

What staff see

Need help?

Help setting up an organization palette is free. If you want the settings text written for you, email [email protected] with your colors, how many palettes you need, and whether to lock them. For anything else, see the support page.