Create Custom Color Palettes

You can customize visualization colors by loading your own RGB color palettes into your workspaces.

You can apply a color palette for the whole organization through the user interface in the Appearance section. All workspaces in this organization then inherit the palette.

Appearance section in the Settings tab showing theme selection and visualization color palette options, with Indigo selected as the current theme and a custom color palette displayed with a sample of color swatches.

To use a custom color palette, you must:

  1. Define the JSON structure.
  2. Create a color palette in the Appearance section of your organization with this JSON.
    You can create multiple palettes and then apply the one palette you want to use.
  3. Apply the palette.

Define Color Palettes

Based on your requirements, define the color palette that you want to use.

If you have the structure prepared, proceed to create.

Create Color Palettes

To create a custom color palette:

  1. Go to the Appearance section in your workspace.
  2. In the Visualization color palette section, click + Create.
  3. Type a name for your palette.
  4. In the Definition, paste the JSON structure that you created.
  5. Click Save.
Create visualization color palette dialog with a text field for entering the name of the palette, a large code editor area filled with JSON defining RGB values, and a vertical list of color palette templates on the right labeled Fresh, Contrast, Cherry iris, Sand purple, and Modern.

On the right side of the dialog window, you can find example templates - hover over the template and click Paste to paste the JSON directly in the Definition section.

Apply Color Palettes

The color palette that you apply in the Appearance section is applied to all workspaces in your organization. However, you can enable a different color palette for individual workspaces via API.

The following image shows the hierarchy and how color palettes are inherited.

Diagram showing the hierarchy of color palette inheritance. At the top, the Organization has Color palette 1 set as an entity setting. Its first workspace inherits Color palette 1, the second workspace has Color palette 2 set directly as an entity setting. The second workspace has two child workspaces. One inherits its palette from the parent workspace above, therefore also uses Color palette 2, the other has Color palette 3 set directly as an entity setting.

Organization

To apply a custom color palette for the whole organization:

  1. Select the palette in the Appearance section.
  2. Click Apply.
  3. Confirm.

From now on, all the workspaces in your organization will use this color palette in visualizations.

Visualization color palette dialog showing Default and Custom sections. In the Custom section, Palette 1 is selected using a radio button on the left. The Apply button located in the bottom right corner of the dialog is highlighted.

Workspace

To apply a different color palette for individual workspaces:

Go to the Workspaces tab and open the workspace you want to edit. Open the Settings tab and click Change in the Visualization color palette section.

Appearance section in the Settings tab of a workspace showing the Visualization color palette setting with the currently selected palette. The Change button is located to the right of the color palette name.
  1. List all the color palettes in your organization.
    GET $HOST_URL/api/v1/entities/colorPalettes?sort=name&size=250&page=0
    
  2. Select the color palette that you want to use and copy its id (identifier).
  3. Apply the palette with the following :
    POST $HOST_URL/api/v1/entities/workspaces/{workspaceId}/workspaceSettings
    
    {
        "data": {
            "type": "workspaceSetting",
            "id": "{someId}",
            "attributes": {
                "content": {
                    "id": "{colorPaletteId}}",
                    "type": "colorPalette"
                },
                "type": "ACTIVE_COLOR_PALETTE"
            }
        }
    }
    

From now on, this workspace will use this color palette that you applied regardless of the organization settings in the Apperance section.

User

To apply a different color palette for individual users:

  1. List all the color palettes in your organization.
    GET $HOST_URL/api/v1/entities/colorPalettes?sort=name&size=250&page=0
    
  2. Select the color palette that you want to use and copy its id (identifier).
  3. Create the colorPalette user settings:
    POST $HOST_URL/api/v1/entities/users/{userId}/userSettings
    
    {
        "data": {
            "type": "userSetting",
            "id": "{settingId}",
            "attributes": {
                "content": {
                    "id": "{colorPaletteId}",
                    "type": "colorPalette"
                },
                "type": "ACTIVE_COLOR_PALETTE"
            }
        }
    }
    

From now on, this user will use this color palette that you applied regardless of the organization or workspace settings in the Apperance section.

Edit Color Palettets

  1. In the Appearance section, click the three dots next to the color palette name.
  2. Select Edit.
  3. Make your changes.
  4. Click Save.
Visualization color palette selection dialog showing custom palettes. Palette 1 is selected, and the ellipsis button to the right of it is highlighted. A dropdown menu is open with options to Edit and Delete the palette.

Delete Color Palettets

You can delete only color palettes that are not applied on the organization level.

Individual workspaces that use the deleted color palette will be changed to the default Indigo color palette.

To delete a custom color palette:

  1. In the Appearance section, click the three dots next to the color palette name.
  2. Select Delete.
  3. Confirm.

Examples

Here is the default color palette for you to compare.

A treemap visualization showcasing the default Indigo color palette.

Fresh

A treemap visualization showcasing the Fresh color palette.
[
    {
        "guid": "01",
        "fill": {
            "r": 140,
            "g": 125,
            "b": 232
        }
    },
    {
        "guid": "02",
        "fill": {
            "r": 125,
            "g": 219,
            "b": 232
        }
    },
    {
        "guid": "03",
        "fill": {
            "r": 125,
            "g": 232,
            "b": 174
        }
    },
    {
        "guid": "04",
        "fill": {
            "r": 211,
            "g": 232,
            "b": 125
        }
    },
    {
        "guid": "05",
        "fill": {
            "r": 232,
            "g": 221,
            "b": 125
        }
    },
    {
        "guid": "06",
        "fill": {
            "r": 82,
            "g": 64,
            "b": 191
        }
    },
    {
        "guid": "07",
        "fill": {
            "r": 64,
            "g": 176,
            "b": 191
        }
    },
    {
        "guid": "08",
        "fill": {
            "r": 51,
            "g": 204,
            "b": 121
        }
    },
    {
        "guid": "09",
        "fill": {
            "r": 173,
            "g": 204,
            "b": 51
        }
    },
    {
        "guid": "10",
        "fill": {
            "r": 204,
            "g": 189,
            "b": 51
        }
    }
]

Contrast

A treemap visualization showcasing the Contrast color palette.
[
    {
        "guid": "01",
        "fill": {
            "r": 193,
            "g": 94,
            "b": 217
        }
    },
    {
        "guid": "02",
        "fill": {
            "r": 118,
            "g": 217,
            "b": 93
        }
    },
    {
        "guid": "03",
        "fill": {
            "r": 217,
            "g": 94,
            "b": 168
        }
    },
    {
        "guid": "04",
        "fill": {
            "r": 93,
            "g": 217,
            "b": 195
        }
    },
    {
        "guid": "05",
        "fill": {
            "r": 217,
            "g": 94,
            "b": 94
        }
    },
    {
        "guid": "06",
        "fill": {
            "r": 93,
            "g": 187,
            "b": 217
        }
    },
    {
        "guid": "07",
        "fill": {
            "r": 217,
            "g": 153,
            "b": 94
        }
    },
    {
        "guid": "08",
        "fill": {
            "r": 94,
            "g": 136,
            "b": 217
        }
    },
    {
        "guid": "09",
        "fill": {
            "r": 217,
            "g": 212,
            "b": 93
        }
    },
    {
        "guid": "10",
        "fill": {
            "r": 118,
            "g": 94,
            "b": 217
        }
    },
    {
        "guid": "11",
        "fill": {
            "r": 142,
            "g": 177,
            "b": 134
        }
    },
    {
        "guid": "12",
        "fill": {
            "r": 175,
            "g": 124,
            "b": 187
        }
    },
    {
        "guid": "13",
        "fill": {
            "r": 123,
            "g": 187,
            "b": 176
        }
    },
    {
        "guid": "14",
        "fill": {
            "r": 187,
            "g": 124,
            "b": 162
        }
    },
    {
        "guid": "15",
        "fill": {
            "r": 123,
            "g": 172,
            "b": 187
        }
    },
    {
        "guid": "16",
        "fill": {
            "r": 187,
            "g": 124,
            "b": 124
        }
    },
    {
        "guid": "17",
        "fill": {
            "r": 124,
            "g": 145,
            "b": 187
        }
    },
    {
        "guid": "18",
        "fill": {
            "r": 187,
            "g": 154,
            "b": 124
        }
    },
    {
        "guid": "19",
        "fill": {
            "r": 136,
            "g": 124,
            "b": 187
        }
    },
    {
        "guid": "20",
        "fill": {
            "r": 187,
            "g": 185,
            "b": 123
        }
    }
]

Cherry Iris

A treemap visualization showcasing the Cherry iris palette.
[
    {
        "guid": "01",
        "fill": {
            "r": 217,
            "g": 94,
            "b": 94
        }
    },
    {
        "guid": "02",
        "fill": {
            "r": 223,
            "g": 121,
            "b": 124
        }
    },
    {
        "guid": "03",
        "fill": {
            "r": 226,
            "g": 146,
            "b": 155
        }
    },
    {
        "guid": "04",
        "fill": {
            "r": 226,
            "g": 171,
            "b": 187
        }
    },
    {
        "guid": "05",
        "fill": {
            "r": 224,
            "g": 196,
            "b": 220
        }
    },
    {
        "guid": "06",
        "fill": {
            "r": 212,
            "g": 176,
            "b": 232
        }
    },
    {
        "guid": "07",
        "fill": {
            "r": 198,
            "g": 163,
            "b": 236
        }
    },
    {
        "guid": "08",
        "fill": {
            "r": 183,
            "g": 149,
            "b": 239
        }
    },
    {
        "guid": "09",
        "fill": {
            "r": 168,
            "g": 136,
            "b": 242
        }
    },
    {
        "guid": "10",
        "fill": {
            "r": 151,
            "g": 123,
            "b": 245
        }
    }
]

Sand Purple

A treemap visualization showcasing the Sand purple palette.
[
    {
        "guid": "01",
        "fill": {
            "r": 242,
            "g": 230,
            "b": 135
        }
    },
    {
        "guid": "02",
        "fill": {
            "r": 233,
            "g": 220,
            "b": 150
        }
    },
    {
        "guid": "03",
        "fill": {
            "r": 213,
            "g": 183,
            "b": 123
        }
    },
    {
        "guid": "04",
        "fill": {
            "r": 208,
            "g": 170,
            "b": 139
        }
    },
    {
        "guid": "05",
        "fill": {
            "r": 195,
            "g": 147,
            "b": 136
        }
    },
    {
        "guid": "06",
        "fill": {
            "r": 180,
            "g": 131,
            "b": 131
        }
    },
    {
        "guid": "07",
        "fill": {
            "r": 182,
            "g": 129,
            "b": 157
        }
    },
    {
        "guid": "08",
        "fill": {
            "r": 199,
            "g": 138,
            "b": 197
        }
    },
    {
        "guid": "09",
        "fill": {
            "r": 152,
            "g": 106,
            "b": 190
        }
    },
    {
        "guid": "10",
        "fill": {
            "r": 122,
            "g": 82,
            "b": 209
        }
    },
    {
        "guid": "11",
        "fill": {
            "r": 96,
            "g": 124,
            "b": 235
        }
    },
    {
        "guid": "12",
        "fill": {
            "r": 107,
            "g": 160,
            "b": 235
        }
    },
    {
        "guid": "13",
        "fill": {
            "r": 129,
            "g": 183,
            "b": 238
        }
    },
    {
        "guid": "14",
        "fill": {
            "r": 142,
            "g": 198,
            "b": 240
        }
    },
    {
        "guid": "15",
        "fill": {
            "r": 146,
            "g": 209,
            "b": 242
        }
    },
    {
        "guid": "16",
        "fill": {
            "r": 146,
            "g": 224,
            "b": 242
        }
    },
    {
        "guid": "17",
        "fill": {
            "r": 146,
            "g": 236,
            "b": 242
        }
    },
    {
        "guid": "18",
        "fill": {
            "r": 159,
            "g": 239,
            "b": 233
        }
    },
    {
        "guid": "19",
        "fill": {
            "r": 128,
            "g": 234,
            "b": 226
        }
    },
    {
        "guid": "20",
        "fill": {
            "r": 80,
            "g": 226,
            "b": 215
        }
    }
]

Modern

A treemap visualization showcasing the Modern palette.
[
    {
        "guid": "01",
        "fill": {
            "r": 206,
            "g": 132,
            "b": 209
        }
    },
    {
        "guid": "02",
        "fill": {
            "r": 49,
            "g": 85,
            "b": 229
        }
    },
    {
        "guid": "03",
        "fill": {
            "r": 63,
            "g": 52,
            "b": 118
        }
    },
    {
        "guid": "04",
        "fill": {
            "r": 192,
            "g": 228,
            "b": 179
        }
    },
    {
        "guid": "05",
        "fill": {
            "r": 48,
            "g": 31,
            "b": 53
        }
    },
    {
        "guid": "06",
        "fill": {
            "r": 122,
            "g": 163,
            "b": 188
        }
    },
    {
        "guid": "07",
        "fill": {
            "r": 251,
            "g": 180,
            "b": 245
        }
    },
    {
        "guid": "08",
        "fill": {
            "r": 164,
            "g": 231,
            "b": 225
        }
    }
]