Palettes

Named color schemes are scale inputs, not themes. Pass a scheme name into a color or fill scale child to encode data series. Chart paper and axes stay on themes.

Every scheme shows its swatch inline below. Select a categorical swatch to preview it on a chart on the Palettes showcase; sequential ramps live on Sequential color ramps.

Using schemes

Categorical names pair with discrete / ordinal scales. Sequential names pair with continuous, binned, or discrete-sampled viridis shells. A scheme from the wrong family is a validation error (scale-scheme-type).

<script lang="ts">
  import {
    GeomPoint,
    GGPlot,
    ScaleColorDiscrete,
  } from "@ggts-sh/svelte";

  const rows = [
    { x: 1, y: 2, species: "a" },
    { x: 2, y: 4, species: "b" },
  ];
</script>

<GGPlot data={rows} aes={{ x: "x", y: "y", color: "species" }}>
  <GeomPoint />
  <ScaleColorDiscrete scheme="observable10" />
</GGPlot>
<ScaleColorContinuous scheme="viridis" />
<!-- or family shell: -->
<ScaleColorViridisC option="magma" />

Scale helpers

Discrete (categorical schemes)

Pass scheme="observable10" (or another categorical name) on discrete/ordinal shells. Brewer and hue set the scheme by construction; grey bakes an explicit range.

  • <ScaleColorDiscrete />
  • <ScaleFillDiscrete />
  • <ScaleColorOrdinal />
  • <ScaleFillOrdinal />
  • <ScaleColorBrewer />
  • <ScaleFillBrewer />
  • <ScaleColorHue />
  • <ScaleFillHue />
  • <ScaleColorGrey />
  • <ScaleFillGrey />
  • <ScaleColorManual />
  • <ScaleFillManual />

Continuous and binned (sequential schemes)

Pass scheme="viridis" (or another sequential name) on continuous/binned shells. Gradient* helpers take explicit color stops instead of a name.

  • <ScaleColorContinuous />
  • <ScaleFillContinuous />
  • <ScaleColorBinned />
  • <ScaleFillBinned />
  • <ScaleColorViridisC />
  • <ScaleColorViridisD />
  • <ScaleColorViridisB />
  • <ScaleColorDistiller />
  • <ScaleColorFermenter />
  • <ScaleColorGradient />
  • <ScaleColorGradient2 />
  • <ScaleColorGradientn />

British Colour aliases export the same components (ScaleColourDiscrete, …). Snake_case builder helpers (scale_color_discrete) accept the same options.

Categorical schemes

Use with ScaleColorDiscrete, ScaleFillDiscrete, ordinal shells, or family-specific helpers. Default when unset: observable10.

schemeswatchPrimary helpersNotes
observable10ScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Default categorical scheme when none is set.
ipsumScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
flexokiScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
colorblindScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
stataScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
economistScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
solarizedScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
fewScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
few_lightScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
few_darkScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
fivethirtyeightScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
ptolScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
canvaScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
wsjScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
wsj_rgbyScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
wsj_red_greenScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
wsj_black_greenScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
wsj_dem_repScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
tableau20ScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
tableau_colorblindScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
tableau_seattle_graysScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
tableau_jewel_brightScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
tableau_hue_circleScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
panderScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal —
Dark2ScaleColorBrewer,ScaleFillBrewer,ScaleColorDiscrete,ScaleFillDiscrete +2ColorBrewer qualitative — prefer <ScaleColorBrewer palette="Dark2" /> (maps to scheme).
hueScaleColorHue,ScaleFillHue,ScaleColorDiscrete,ScaleFillDiscrete +2Default discrete path; also scheme="hue" on ordinal scales.
actonSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.
bamakoSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.
batlowSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.
batlowWSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.
batlowKSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.
bilbaoSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.
budaSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.
davosSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.
devonSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.
glasgowSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.
grayCSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.
hawaiiSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.
imolaSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.
lajollaSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.
lapazSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.
lipariSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.
naviaSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.
nuukSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.
osloSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.
tokyoSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.
turkuSScaleColorDiscrete,ScaleFillDiscrete,ScaleColorOrdinal,ScaleFillOrdinal Crameri categorical (v8.0.1) — 10-class unordered prefix of the official *S table.

Sequential schemes

Use with continuous / binned color scales, viridis family shells, ColorBrewer distiller/fermenter, or discrete sampling of a viridis ramp (ScaleColorViridisD).

schemeswatchPrimary helpersNotes
viridisScaleColorViridisC,ScaleColorViridisD,ScaleColorViridisB,ScaleFillViridisC +8Viridis family — <ScaleColorViridisC option="viridis" /> or scheme on continuous/discrete.
magmaScaleColorViridisC,ScaleColorViridisD,ScaleColorViridisB,ScaleFillViridisC +8Viridis family — <ScaleColorViridisC option="magma" /> or scheme on continuous/discrete.
plasmaScaleColorViridisC,ScaleColorViridisD,ScaleColorViridisB,ScaleFillViridisC +8Viridis family — <ScaleColorViridisC option="plasma" /> or scheme on continuous/discrete.
infernoScaleColorViridisC,ScaleColorViridisD,ScaleColorViridisB,ScaleFillViridisC +8Viridis family — <ScaleColorViridisC option="inferno" /> or scheme on continuous/discrete.
cividisScaleColorViridisC,ScaleColorViridisD,ScaleColorViridisB,ScaleFillViridisC +8Viridis family — <ScaleColorViridisC option="cividis" /> or scheme on continuous/discrete.
turboScaleColorViridisC,ScaleColorViridisD,ScaleColorViridisB,ScaleFillViridisC +8Viridis family — <ScaleColorViridisC option="turbo" /> or scheme on continuous/discrete.
BluesScaleColorDistiller,ScaleFillDistiller,ScaleColorFermenter,ScaleFillFermenter +4ColorBrewer ramp — Distiller (continuous), Fermenter (binned), or scheme on continuous.
GreensScaleColorDistiller,ScaleFillDistiller,ScaleColorFermenter,ScaleFillFermenter +4ColorBrewer ramp — Distiller (continuous), Fermenter (binned), or scheme on continuous.
RedsScaleColorDistiller,ScaleFillDistiller,ScaleColorFermenter,ScaleFillFermenter +4ColorBrewer ramp — Distiller (continuous), Fermenter (binned), or scheme on continuous.
OrangesScaleColorDistiller,ScaleFillDistiller,ScaleColorFermenter,ScaleFillFermenter +4ColorBrewer ramp — Distiller (continuous), Fermenter (binned), or scheme on continuous.
PurplesScaleColorDistiller,ScaleFillDistiller,ScaleColorFermenter,ScaleFillFermenter +4ColorBrewer ramp — Distiller (continuous), Fermenter (binned), or scheme on continuous.
GreysScaleColorDistiller,ScaleFillDistiller,ScaleColorFermenter,ScaleFillFermenter +4ColorBrewer ramp — Distiller (continuous), Fermenter (binned), or scheme on continuous.
YlOrRdScaleColorDistiller,ScaleFillDistiller,ScaleColorFermenter,ScaleFillFermenter +4ColorBrewer ramp — Distiller (continuous), Fermenter (binned), or scheme on continuous.
YlGnBuScaleColorDistiller,ScaleFillDistiller,ScaleColorFermenter,ScaleFillFermenter +4ColorBrewer ramp — Distiller (continuous), Fermenter (binned), or scheme on continuous.
BuPuScaleColorDistiller,ScaleFillDistiller,ScaleColorFermenter,ScaleFillFermenter +4ColorBrewer ramp — Distiller (continuous), Fermenter (binned), or scheme on continuous.
RdYlBuScaleColorDistiller,ScaleFillDistiller,ScaleColorFermenter,ScaleFillFermenter +4ColorBrewer ramp — Distiller (continuous), Fermenter (binned), or scheme on continuous.
RdBuScaleColorDistiller,ScaleFillDistiller,ScaleColorFermenter,ScaleFillFermenter +4ColorBrewer ramp — Distiller (continuous), Fermenter (binned), or scheme on continuous.
BrBGScaleColorDistiller,ScaleFillDistiller,ScaleColorFermenter,ScaleFillFermenter +4ColorBrewer ramp — Distiller (continuous), Fermenter (binned), or scheme on continuous.
SpectralScaleColorDistiller,ScaleFillDistiller,ScaleColorFermenter,ScaleFillFermenter +4ColorBrewer ramp — Distiller (continuous), Fermenter (binned), or scheme on continuous.
PuOrScaleColorDistiller,ScaleFillDistiller,ScaleColorFermenter,ScaleFillFermenter +4ColorBrewer ramp — Distiller (continuous), Fermenter (binned), or scheme on continuous.
actonScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
bamakoScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
batlowScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
batlowWScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
batlowKScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
bilbaoScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
budaScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
davosScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
devonScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
glasgowScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
grayCScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
hawaiiScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
imolaScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
lajollaScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
lapazScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
lipariScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
naviaScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
naviaWScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
nuukScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
osloScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
tokyoScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
turkuScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
bamScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
berlinScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
brocScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
corkScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
lisbonScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
managuaScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
romaScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
tofinoScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
vanimoScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
vikScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
bukavuScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
fesScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
oleronScaleColorContinuous,ScaleFillContinuous,ScaleColorBinned,ScaleFillBinned Crameri Scientific colour map (v8.0.1) — continuous, CVD-friendly.
bamOScaleColorContinuous,ScaleFillContinuous Crameri cyclic (v8.0.1) — periodic data only; wrap OOB; set an explicit domain period.
brocOScaleColorContinuous,ScaleFillContinuous Crameri cyclic (v8.0.1) — periodic data only; wrap OOB; set an explicit domain period.
corkOScaleColorContinuous,ScaleFillContinuous Crameri cyclic (v8.0.1) — periodic data only; wrap OOB; set an explicit domain period.
romaOScaleColorContinuous,ScaleFillContinuous Crameri cyclic (v8.0.1) — periodic data only; wrap OOB; set an explicit domain period.
vikOScaleColorContinuous,ScaleFillContinuous Crameri cyclic (v8.0.1) — periodic data only; wrap OOB; set an explicit domain period.

See also