Skip to main content
A color clustering widget groups ad creatives by their dominant color. Each cluster becomes a data point on the chart, plotted against two chosen metrics. The visual makes it easy to see which creative color palettes correlate with strong performance — “do our blue creatives outperform our red creatives on CTR?” or “which color palette drives the lowest CPA?”

​
When to use color clustering

  • Compare creative performance across color families.
  • Spot which color clusters drive the strongest efficiency.
  • Support creative-refresh decisions with data instead of intuition.

​
Configure a color clustering widget

​
Mandatory fields

1

Pick a data source

In the Data sources section, select ad data sources whose creatives include image content. Color clustering requires image creatives — non-image ads (text-only, video-only) can’t be color-analyzed.
2

Pick a Y-axis metric

Click Edit on the Y-axis field to open the picker panel. Pick up to 20 metrics to make available in the widget’s dropdown, reorder them if needed, and set the active one shown by default. The active metric renders as the value plotted on the vertical axis — for example, CTR or Conversions.New custom metrics can be created directly from the picker panel without leaving the chart widget.
3

Pick an X-axis metric

Click Edit on the X-axis field to open the picker panel. Pick up to 20 metrics to make available in the widget’s dropdown, reorder them if needed, and set the active one shown by default. The active metric renders as the value plotted on the horizontal axis — for example, Spend. Each cluster is plotted at (X, Y).
Color clustering widgets don’t have a Group by picker — clusters are computed automatically from the creative image data. Widget changes save automatically when the settings panel closes. Persist changes to the dashboard by clicking Save dashboard.

​
Optional fields

  • Widget filter — narrow the creatives feeding the widget. See Filters.
  • Hide metric value — hide items whose Ad Spend, Impressions, or Link Clicks meet a threshold. Two blocks are available: a preset “Value = 0” checkbox per metric, and a custom threshold block with an operator (default ≤) and value. Both can be combined.
  • Period — override the dashboard’s date range. See Date ranges.
  • Grid — toggle background gridlines.
  • Chart controls — toggle whether Chart controls render on this widget. On by default.

​
Chart controls

Chart controls are toggled on or off per widget from the Chart controls switch in the widget settings panel. When off, Chart controls don’t render on the widget; when on, the dropdowns configured below appear on the widget. Some key settings can be updated directly from the widget header without opening the settings panel. The Chart controls on a color clustering widget expose:
  • Chart type — a switcher on the left of the widget header to change to another chart type.
  • Y-axis — swap the vertical metric inline.
  • X-axis — swap the horizontal metric inline.
Changes made in the Chart controls aren’t saved automatically — click Save dashboard to persist them. Chart controls are read-only when viewing a shared dashboard. In shared dashboards, Chart controls show only the items selected in each field, matching what the dashboard owner configured.

​
What the visual encodes

  • Cluster color — the dominant color of the creatives in that cluster, so the dot itself signals which color family it represents.
  • Dot position — the cluster’s aggregate value on the X and Y metrics.
  • Cluster label — a human-friendly color name (for example, “Navy Blue”, “Coral”).

​
Cluster limit

Color clustering produces up to 10 clusters per widget. When there are fewer than 10 distinct dominant colors across the creatives, the cluster count drops to match. Clustering is deterministic — the same creatives always land in the same clusters (fixed random seed).

​
Comparison mode

Color clustering widgets do not render comparison values. Even when the Compare toggle is on, the widget draws only the primary window.

​
Widget styling

Global widget style settings — font, border, background, and color themes — apply to every widget through the Dashboard style settings. On top of those, Color clustering widgets have style options unique to this widget type:
  • Data Label — HEX color for the cluster label text drawn on the chart.
  • Data Label Stroke — HEX color and opacity for the stroke around the cluster label text.

​
Troubleshooting

Color clustering needs ad creatives with image content. Confirm the selected data sources include image ads (not just text or video), and that the date range covers periods with active image creatives. See Data not loading.
The creative library has very few distinct dominant colors. Widen the date range or ad-account selection to include more creatives.
Color clustering doesn’t apply to analytics, e-commerce, or spreadsheet sources — no creative images exist to analyze.

Word cloud

Surface high-performing terms across ad names or copy.

Scatter plot

Plot any two numeric metrics on X and Y axes.