World Map
Color countries on a world map by a numeric measure. Ideal for geographic comparisons — GDP by country, population density, sales by region, or any metric that varies across nations. Country names are resolved to ISO numeric codes against the bundled atlas, so common spellings and case variants all work out of the box.
Examples
When to Use
- Comparing a single metric across countries or world regions
- Highlighting geographic clusters or outliers in your data
- Showing sales, population, or economic data on a map
- Providing a quick visual summary of global distribution
Data Roles
Build These Examples
Location + Values is the only required pairing — the optional Tooltips well enriches the hover card without changing the country colors.
Settings
Layout
Projection
dropdownMap projection: equal-earth, natural-earth, mercator, equirectangular, or orthographic.
Default:equirectangularScale
dropdownColor scale type: linear or log.
Default:linearFit to Data
booleanCrop the map to the bounding box of countries with data.
Default:falseShow Graticule
booleanOverlay latitude/longitude grid lines.
Default:falseColor
Mode
dropdownPre-built palette or custom min → mid → max gradient.
Default:gradientPalette
dropdownSequential palette name when in gradient mode.
Default:bluesNo Data Color
colorFill for countries with no value.
Default:#eef2f6Borders
Show Borders
booleanDraw a stroke around each country.
Default:trueStroke Width
numberBorder stroke width in pixels.
Default:0.5Legend
Show
booleanDisplay the gradient legend ramp.
Default:truePosition
dropdownLegend placement: top/bottom × left/right or bottom-center.
Default:bottomLeftCommon settings like Tooltip and Small Multiples are covered in Shared Concepts.
Tips & Best Practices
- Country names are matched case-insensitively — "united states", "United States", and "UNITED STATES" all work
- Countries with no data are rendered in the no-data color, making gaps easy to spot
- Use a sequential color scheme like "blues" or "greens" for quantitative comparisons