Project Status:Active CRAN_Status_Badge R build status Codecov test coverage

The ipumsr package helps import IPUMS extracts from the IPUMS website into R. IPUMS provides census and survey data from around the world integrated across time and space. IPUMS integration and documentation makes it easy to study change, conduct comparative research, merge information across data types, and analyze individuals within family and community context. Data and services are available free of charge.

The ipumsr package can be installed by running the following command:


Or, you can install the development version using the following commands:

if (!require(devtools)) install.packages("devtools")


Learning More

The vignettes are a great place to learn more about ipumsr and IPUMS data:

You can access them from R with the vignette() command (eg vignette("value-labels")).

If you are installing from github and want the vignettes, you’ll need to run the following commands first:

devtools::install_github("mnpopcenter/ipumsr", build_vignettes = TRUE)


We greatly appreciate bug reports, suggestions or pull requests. They can be submitted via github, on our user forum or by email to ipums@umn.edu

Before contributing, please be sure to read the Contributing Guidelines and the Code of Conduct.