Choroplethr is a suite of R packages that facilitates mapping demographic statistics. The name "Choroplethr" comes from combining the words "choropleth map" and "R programming language". A choropleth is any map that shows regions, and expresses values for those regions with color.

Choroplethr is easy to use, has built-in support for mapping every country in the world and integrates with several open data sources, such as the US Census Bureau's American Community Survey (ACS).

Free Choroplethr Course

The most popular way to learn Choroplethr is with my free email course Learn to Map Census Data in RYou will receive one email a day for a week, and each email contains a short technical lesson. The course teaches you how to make this map, which shows how US Per Capita Income has changed over time.


Choroplethr has led to a number of projects that leverage R, maps and open data sets. Past clients have come from the private sector as well as government agencies and non-profits. You can learn more about those projects, as well as how to get consulting help on your project, here.

Asking Questions

If you have a technical question related to Choroplethr, I recommend asking on Stack Overflow. Please tag your question with the keyword "choroplethr". (Click here to see past questions).


Mapping Census Bureau Data in R with Choroplethr

I worked with the Census Bureau to create a free 18-part video course on using Choroplethr to Analyze US Census Bureau Data. If you are already familiar with Choroplethr, I recommend starting with Module 4 ("Data Details").

Mapmaking in R with Choroplethr

This course is the definitive guide to working with Choroplethr. It teaches you how to conduct exploratory analysis with Choroplethr, as well as how to use each of the maps that Choroplethr ships with.

Shapefiles for R Programmers

This course teaches you how to work with Shapefiles in R. This is especially useful if you need to work with maps that are not already packaged on CRAN.

Mapmaking and Shapefiles can be purchased individually, or at a discount as part of the R Mapping Bundle.

R Mapping Bundle


While Choroplethr is conceptually one body of work, it is divided into five different R packages. The technical documentation provides detailed information about each package, including examples of using most functions and data objects in each package. You can read the technical documentation for choroplethr here