US States Choropleth Map

An interactive choropleth map of the United States. Supply state-level data (JSON or CSV with state names and numeric values) and the map will color-code each state accordingly. Supports custom titles, subtitles, color ranges, and dynamic data updates via the standard onDynamicDa

Template details

  • map
  • choropleth
  • usa
  • states
  • geographic
  • d3

When to use this template

This visualization excels at revealing geographic patterns and disparities of a single metric across the United States. Analysts use it to quickly identify states or regions performing exceptionally well or poorly, understand spatial clusters, and communicate state-level comparisons intuitively. It helps answer questions about where phenomena are most concentrated or sparse.

  • Datasets with exactly one numeric value per US state.
  • Data where state names or standard abbreviations are primary keys.
  • Quantitative metrics, suitable for continuous color scales.
  • Comparisons of a single variable across all 50 US states.
  • Identifying regional trends or outliers in state-level data.
  • Static or periodically updated state-level performance indicators.

Browse all Koan templates