# Color reference

Below are details on the different color palettes and scales that Kumu supports. Use these with the [Color by](https://docs.kumu.io/guides/decorate#color-by) tool in the Basic Editor, or use them in the [Advanced Editor](https://docs.kumu.io/guides/decorate#decorate-in-the-advanced-editor) with the `categorize()` and `scale()` functions.

## Named color scales

Kumu has built-in support for a number of named color scales, including all [ColorBrewer](http://bl.ocks.org/mbostock/5577023) scales.

### Sequential and diverging

Both sequential and diverging color palettes are great when you are trying to show quantitative data or data that has a meaningful order.

<table><thead><tr><th width="115.00000000000003"></th><th></th></tr></thead><tbody><tr><td>YlGn</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-366f481a1b340a6dfc67393fc11339e046216c1d%2Fylgn.svg?alt=media" alt="YlGn" data-size="line"></td></tr><tr><td>YlGnBu</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-ea1c63a232e847b84292d3db3c2e2527705b6114%2Fylgnbu.svg?alt=media" alt="YlGnBu" data-size="line"></td></tr><tr><td>GnBu</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-6eeeb8f40f38bdfa5039c32f60a0855aee7e5daa%2Fgnbu.svg?alt=media" alt="GnBu" data-size="line"></td></tr><tr><td>BuGn</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-134d0e757c1427674eac68d4678b1369f2698e19%2Fbugn.svg?alt=media" alt="BuGn" data-size="line"></td></tr><tr><td>PuBuGn</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-5ff5c5156b31df39ee43a0bbef4dfa7d40ed0e35%2Fpubugn.svg?alt=media" alt="PuBuGn" data-size="line"></td></tr><tr><td>PuBu</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-0b0d9358aceee6aa8d3d6b17096177297d31f0d5%2Fpubu.svg?alt=media" alt="PuBu" data-size="line"></td></tr><tr><td>BuPu</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-77fd8392fffcd91d293fee5adecc5ff04f142370%2Fbupu.svg?alt=media" alt="BuPu" data-size="line"></td></tr><tr><td>RdPu</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-bb7f7a030aa029797f9dcd868284169819f9fe9a%2Frdpu.svg?alt=media" alt="RdPu" data-size="line"></td></tr><tr><td>PuRd</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-5cd6fcd6d9a5177aec104eb99df19b3240f19977%2Fpurd.svg?alt=media" alt="PuRd" data-size="line"></td></tr><tr><td>OrRd</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-26906a6ddd09c7e7ab1bba4c0d155d45747db631%2Forrd.svg?alt=media" alt="OrRd" data-size="line"></td></tr><tr><td>YlOrRd</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-e6daac0fb0a1b5f213f8ce1d67a8f451bb21cfdd%2Fylorrd.svg?alt=media" alt="YlOrRd" data-size="line"></td></tr><tr><td>YlOrBr</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-5250c0a69e048ee6797dac329c7638da8595a70f%2Fylorbr.svg?alt=media" alt="YlOrBr" data-size="line"></td></tr><tr><td>Purples</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-65c69ba0424901534ee0bb53d305e1f45ee889fd%2Fpurples.svg?alt=media" alt="Purples" data-size="line"></td></tr><tr><td>Blues</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-500bd8aae6a076c59adc938ef2f2e52e241b7b74%2Fblues.svg?alt=media" alt="Blues" data-size="line"></td></tr><tr><td>Greens</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-fb35798e80dc03c9f9e2f004b5f1b34c34048c48%2Fgreens.svg?alt=media" alt="Greens" data-size="line"></td></tr><tr><td>Oranges</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-e0ad961e42da6156282f0ad4dce26a2f9cd39896%2Foranges.svg?alt=media" alt="Oranges" data-size="line"></td></tr><tr><td>Reds</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-248caccfa12bfea0904c04e1329cf56a60273c53%2Freds.svg?alt=media" alt="Reds" data-size="line"></td></tr><tr><td>Greys</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-a22d32d87b40220479ea23186bd826a276fbb1fc%2Fgreys.svg?alt=media" alt="Greys" data-size="line"></td></tr><tr><td>PuOr</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-4d9687e209f021bce2be203593eed4c49b53bc2c%2Fpuor.svg?alt=media" alt="PuOr" data-size="line"></td></tr><tr><td>BrBG</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-4f92561878664cc05aaeda51a2f11d3dfbe8fc84%2Fbrbg.svg?alt=media" alt="BrBG" data-size="line"></td></tr><tr><td>PRGn</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-1a5a153dfc5a011e225beb93bc9fec9d0addf4b2%2Fprgn.svg?alt=media" alt="PRGn" data-size="line"></td></tr><tr><td>PiYG</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-a55d4f9ec3d278889d2661010f73c5d9103c8719%2Fpiyg.svg?alt=media" alt="PiYG" data-size="line"></td></tr><tr><td>RdBu</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-146a9a6f9c2e0f708a39f9204d10f3c203b70f0b%2Frdbu.svg?alt=media" alt="RdBu" data-size="line"></td></tr><tr><td>RdGy</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-940d4bfd61bc97350e3e734f9d959065f77434a8%2Frdgy.svg?alt=media" alt="RdGy" data-size="line"></td></tr><tr><td>RdYlBu</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-b0b84d9895f25ce7412a0f0559debcf119780d73%2Frdylbu.svg?alt=media" alt="RdYlBu" data-size="line"></td></tr><tr><td>Spectral</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-2470e93ca23559007dd0a8b2652465406f9ba46b%2Fspectral.svg?alt=media" alt="Spectral" data-size="line"></td></tr><tr><td>RdYlGn</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-073ec1fef868440bcf6bc8a8f869da0c2d13f339%2Frdylgn.svg?alt=media" alt="RdYlGn" data-size="line"></td></tr><tr><td>nautical</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-cf1e437783985dc402dea98dbf9ad0f38226f211%2Fnautical.svg?alt=media" alt="nautical" data-size="line"></td></tr><tr><td>deepsea</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-6270774af32713efe743f31e93c35a93cf5b9b2a%2Fdeepsea.svg?alt=media" alt="deepsea" data-size="line"></td></tr><tr><td>heat</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-56fc13ba2cfaa479df6db782a66e4d7036ceab6d%2Fheat.svg?alt=media" alt="heat" data-size="line"></td></tr><tr><td>flamingo</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-32382fda57e221977d019b45acc27e2d7beefb16%2Fflamingo.svg?alt=media" alt="flamingo" data-size="line"></td></tr><tr><td>coffee</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-6bf7c18ad876719bb0f8c386962b3b0fd84d7e61%2Fcoffee.svg?alt=media" alt="coffee" data-size="line"></td></tr><tr><td>stoplight</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-e211726992b5ad7d651c4378e89b5b8fcc33d50e%2Fstoplight.svg?alt=media" alt="stoplight" data-size="line"></td></tr></tbody></table>

### Qualitative

Qualitative color palettes are best when you are trying to show data with discrete values that don't have an inherent order.

<table><thead><tr><th width="126.00000000000003"></th><th></th></tr></thead><tbody><tr><td>bujumbra</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-e6870cc9ed93cadee751923d7738f3b434cfc804%2Fbujumbra.svg?alt=media" alt="bujumbra" data-size="line"></td></tr><tr><td>neon</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-18edd2b570e17818fb3428760b569d3d49f56c0c%2Fneon.svg?alt=media" alt="neon" data-size="line"></td></tr><tr><td>neon2</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-8d42924a19dd2fe59a725667d85f93bda3cbfd4e%2Fneon2.svg?alt=media" alt="neon2" data-size="line"></td></tr><tr><td>olympic</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-0c2e34be8471b973e504c6418fdcda9d53f1dc78%2Folympic.svg?alt=media" alt="olympic" data-size="line"></td></tr><tr><td>Accent</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-e864305555435cee0b7543155bea7be79295760a%2Faccent.svg?alt=media" alt="Accent" data-size="line"></td></tr><tr><td>Dark2</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-cc397d7f2853a2902a8bca019ee736b745299b1a%2Fdark2.svg?alt=media" alt="Dark2" data-size="line"></td></tr><tr><td>Paired</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-519f54dd2ddaf452c70cfe8c381135033b9ef003%2Fpaired.svg?alt=media" alt="Paired" data-size="line"></td></tr><tr><td>Pastel1</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-166cbe65dc7210756be4bbfd5c49b63333456abc%2Fpastel1.svg?alt=media" alt="Pastel1" data-size="line"></td></tr><tr><td>Pastel2</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-1e120253b803c7497746bdc259fe554cb4483c39%2Fpastel2.svg?alt=media" alt="Pastel2" data-size="line"></td></tr><tr><td>Set1</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-c827593a0408c57c6e9ff9c2d74817a4c15477f3%2Fset1.svg?alt=media" alt="Set1" data-size="line"></td></tr><tr><td>Set2</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-37ff68029cc748cdeb0aaae7e144bd62b457e397%2Fset2.svg?alt=media" alt="Set2" data-size="line"></td></tr><tr><td>Set3</td><td><img src="https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-479afd20b370a087c4cbc12c86ee66a83aa07f04%2Fset3.svg?alt=media" alt="Set3" data-size="line"></td></tr></tbody></table>

Here's an example of how to use a named color scale:

```scss
element {
  color: scale("net worth", bujumbra);
}
```

## Inverting a color scale

Any color scale can be inverted by adding `-inverted` to the name.

## Defining your own color palette

You can define your own color palette for elements by using a comma separated list of color values.

```scss
@settings {
  element-color: categorize("community", #5BC1AE, #009CDB, #F6882B, #8E278F);
}
```

For [flags](https://docs.kumu.io/guides/decorate/flags), the code is slightly different:

```scss
@settings {
  element-flag: "Tags" with #5BC1AE, #009CDB, #F6882B, #8E278F;
}
```

## Setting explicit stops for color values in categorize()

It's also possible to specify which value should receive a certain color for elements.

```scss
@settings {
  element-color: categorize("element type", #5BC1AE "Person", #009CDB "Organization", #F6882B "Region");
}
```

For [flags](https://docs.kumu.io/guides/decorate/flags), the code is slightly different:

```scss
@settings {
  element-flag: "Tags" with #5BC1AE "Person", #009CDB "Organization", #F6882B "Region;
}
```
