tidycensus

1.8.1

Load US Census Boundary and Attribute Data as 'tidyverse' and 'sf'-Ready Data Frames

24packages depend

156.7Kdownloads / year

19.2%test coverage

9/13checks pass

Overview

About

Maintained by Kyle WalkerFirst published 2017-06-2045 releasesCRAN page ↗GitHub ↗

An integrated R interface to several United States Census Bureau APIs (https://www.census.gov/data/developers/data-sets.html) and the US Census Bureau's geographic boundary files. Allows R users to return Census and ACS data as tidyverse-ready data frames, and optionally returns a list-column with feature geometry for mapping and spatial analysis.

Install

R (CRAN)pak (dev)Ubuntu (r2u)Fedora (COPR)openSUSE (OBS)

install.packages("tidycensus", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("walkerke/tidycensus")

Development version from walkerke/tidycensus. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-tidycensus

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-tidycensus

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-tidycensus

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed).

Health

CRAN checks

4NOTE9OK

Failing flavors

NOTE r-devel-linux-x86_64-debian-clang
NOTE r-devel-linux-x86_64-debian-gcc
NOTE r-devel-linux-x86_64-fedora-gcc
NOTE r-devel-windows-x86_64

Slowest check: 3.1 min · r-devel-linux-x86_64-fedora-clang

Code health

Yes

Tests · ratio 0.10

19.2%

Coverage · measured lines

100%

Documentation · exports

Dependencies · direct

Check history

NOTE2026-07-16
11 OK · 2 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
OK2026-03-10
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMEYes · 115 wordsVignettesNopkgdown siteNoNEWSYes · 100% structuredCode of conductNoContributing guideNo

Examples that run: 11%
Documented parameters: 98%
Return-value docs: 89%
References docs: 0%

Downloads

156.7K

CRAN downloads in the past year

Rank #1,160 · ~429/day · ~13.1K/mo

Releases R versions

Daily download trend is not available in this view yet.

8K30 days

33.6K90 days

156.7K1 year

Compare downloads with other packages →

Also on477 r2u40 autocran5.1K conda_forge774 c2d4u

Repository

GitHub ↗ walkerke/tidycensus

681Stars

103Forks

21Open issues

1Open PRs

2Releases

768Commits

28Contributors

768 commits · Last activity 2026-05-25 · +0.7% stars, 30d

Stars over time

2025-07-06 · 6502026-07-18 · 680

Repository practices

Upstream repositoryBeta

4 development-tooling and community-health practices detected across 4 families in the upstream repository

Checks run against github.com/walkerke/tidycensus on 2026-07-19.

Continuous integration (1)

GitHub Actions

Reproducibility and dev environment (1)

data-raw/

Lint, format, editor (1)

RStudio project

Governance and community (1)

Funding

How this is detected·Detection ruleset v1 (2026-07-18)

Dependencies

Declared dependencies

21 external dependencies (excludes base and recommended)

Depends (1)

R >= 4.1

Imports (16)

httr sf dplyr tigris stringr jsonlite (>= 1.5.0)purrr rvest tidyr readr xml2 unitsutilsrlang crayon tidyselect

LinkingTo (0)

none

Suggests (6)

ggplot2 survey srvyr terra testthat withr

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

24direct

0indirect

Code & Tests

Code Composition

R 8,068 (86%)Rd 1,313 (14%)

Code characteristics

Cyclomatic complexity: 5.5 median / 151 max
Test cases: 26 / 0.10 per code line

Test coverage

Line coverage

19%

Expression

23.5%

Tests / Examples

19.2% / 0% ex

Functions

42 18 exported

Complexity

19.5 avg / 151 max

Call network

42 nodes / 51 edges

Call graph

Open call graph →

Loading call graph…

Lowest coverage

42 functions

Function	Cyclo	Coverage
as_dot_density exp	6	0%
census_api_key exp	6	0%
check_ddhca_groups exp	2	0%
interpolate_pw exp	17	0%
significance exp	5	0%
to_survey exp	15	0%

Datasets

Bundled datasets · 3

Name	Class	Rows × Cols	Also ships in
acs5_geography	tbl_df/tbl/data.frame	14,488 × 3	–
fips_codes	data.frame	3,256 × 5	in 2 packages
pums_variables	tbl_df/tbl/data.frame	80,321 × 12	–

People & History

People (3)

Maintainer (1)

Kyle Walker

Author, Maintainer

Authors (2)

Kyle Walker

Author, Maintainer

Matt Herman

Author · added in 0.9

Contributors (1)

Kris Eberwein

Contributor · added in 0.2

Package Timeline

45 releases. Pick two to compare their code metrics. R releases are shown for context.

1.8.1Latest
2026-05-25 · current release · diff ↗
1.8.0
2026-05-19 · diff ↗
R
R 4.6.0 released · 2026-04-24
1.7.5
2026-02-09 · diff ↗
1.7.3
2025-07-24 · diff ↗
R
R 4.5.0 released · 2025-04-11
1.7.1
2025-01-31 · diff ↗
1.7.0
2025-01-23 · diff ↗
1.6.7
2024-10-17 · diff ↗
1.6.6
2024-09-20 · diff ↗
1.6.5
2024-07-26 · diff ↗
R
R 4.4.0 released · 2024-04-24
1.6.3
2024-03-20 · diff ↗
1.6.2
2024-03-05 · diff ↗
1.6
2024-01-25 · diff ↗
1.5
2023-09-26 · diff ↗

Show 39 earlier events

1.4.4
2023-08-07 · diff ↗
1.4.1
2023-06-03 · diff ↗
1.4
2023-05-27 · diff ↗
1.3.4
2023-05-19 · diff ↗
R
R 4.3.0 released · 2023-04-21
1.3.2
2023-01-30 · diff ↗
1.3.1
2023-01-09 · diff ↗
1.3
2022-12-09 · diff ↗
1.2.3
2022-09-16 · diff ↗
1.2.2
2022-06-03 · diff ↗
R
R 4.2.0 released · 2022-04-22
1.2.1
2022-04-21 · diff ↗
1.2
2022-04-12 · diff ↗
1.1.2
2022-03-09 · diff ↗
1.1
2021-09-23 · diff ↗
1.0
2021-05-19 · diff ↗
R
R 4.1.0 released · 2021-05-18
0.11.4
2021-01-20 · diff ↗
0.11
2020-12-14 · diff ↗
0.10.2
2020-09-28 · diff ↗
0.10.1
2020-09-27 · diff ↗
0.9.9.5
2020-06-10 · diff ↗
R
R 4.0.0 released · 2020-04-24
0.9.9.2
2020-04-03 · diff ↗
0.9.6
2020-01-25 · diff ↗
0.9.5
2020-01-20 · diff ↗
0.9.2
2019-06-12 · diff ↗
R
R 3.6.0 released · 2019-04-26
0.9
2019-01-09 · diff ↗
0.8.1
2018-08-27 · diff ↗
R
R 3.5.0 released · 2018-04-23
0.4.6
2018-04-15 · diff ↗
0.4.1
2018-01-31 · diff ↗
0.4
2018-01-03 · diff ↗
0.3.1
2017-10-26 · diff ↗
0.3
2017-10-17 · diff ↗
0.2
2017-08-09 · diff ↗
0.1.2
2017-06-20
R
R 3.4.0 released · 2017-04-21

Package metadata

First published: 2017-06-20
Total releases: 45 / 9 yrs
License: MIT + file LICENSE OSI
Minimum R: ≥ 4.1
Bundled data: 1.7 MB / 6 files
Download size: 2.2 MB
Installed size: not tracked yet
With dependencies: not tracked yet

Appears in task views

Official Statistics & Survey Statistics Analysis of Spatial Data

Report a problem with this page →