@@ -100,3 +100,58 @@ To set this option:
100
100
#. In the :guilabel:`General Customization` section, set the
101
101
:guilabel:`Data Category Labels` toggle switch to the desired
102
102
setting.
103
+
104
+ Color Palette Customization
105
+ ---------------------------
106
+
107
+ Palette customization allows you to select custom colors for your
108
+ chart. To enable color customization, select the
109
+ :guilabel:`Customization` tab of the :guilabel:`Chart Type` column.
110
+ A toggle switch labeled :guilabel:`Custom Color Palette` appears in
111
+ the :guilabel:`General Customization` section.
112
+
113
+ Most chart types allow you to customize individual colors in their
114
+ palette. The :ref:`heatmap <heatmap-chart-ref>` and :ref:`colored bar
115
+ and column <column-bar-chart-ref>` types use a gradient color scale,
116
+ while other types use a custom color picker. The gradient color
117
+ scale allows you to choose from a set of pre-defined gradients.
118
+
119
+ .. figure:: /images/charts/custom-gradient.png
120
+ :figwidth: 251px
121
+ :alt: Custom color palette selection
122
+
123
+ Other chart types use a color picker for selecting a customized
124
+ set of colors.
125
+
126
+ .. figure:: /images/charts/custom-color-palette.png
127
+ :figwidth: 251px
128
+ :alt: Custom color palette selection
129
+
130
+ For chart types which use a color picker for customization,
131
+ each numbered color swatch corresponds to a data series on the chart.
132
+ Select a color swatch to modify the color of its corresponding
133
+ data series. You can select a new color with a color slider, by
134
+ entering a hex value, by entering RGB values, or by choosing a
135
+ predefined color. You can also drag and drop the existing color
136
+ selections if you want to use the current color choices but change
137
+ which color goes with which data series.
138
+
139
+ .. note::
140
+
141
+ By default, the custom color picker shows color swatches for 10
142
+ data series, but you can only modify as many of the swatches as
143
+ you have data series. The palette can expand to show 20 data series.
144
+ Charts will use as many colors as needed to show your chart,
145
+ starting from the first color. For example, if you have only two
146
+ data series in your chart, only the colors numbered ``1`` and
147
+ ``2`` have any effect on your chart.
148
+
149
+ To close the color customization tool, click somewhere outside it.
150
+ To revert the entire chart to its default colors, set the
151
+ :guilabel:`Custom Color Palette` toggle switch back to :guilabel:`Off`.
152
+
153
+ Applicable Chart Types
154
+ ~~~~~~~~~~~~~~~~~~~~~~
155
+
156
+ This customization option is available for all chart types except
157
+ :ref:`Text <chart-type-text-charts>`.
0 commit comments