Skip to contents

nflreadr (development version)

New data and functions


  • options(nflreadr.verbose) replaces options(nflreadr.cache_warning) as the best way to silence nflreadr messages.
  • Improved data dictionaries for ESPN QBR, Injuries, Trades, Depth Charts, and Combine
  • Exported most_recent_season() function
  • Updated documentation with improved linking and where to file data issues.
  • Sitrep functions have ffopportunity and nflverse packages.
  • Pkgdown site upgraded to Bootstrap 5.

Thank you to @armstjc, @Grayhawk34, @john-b-edwards, @mrcaseb, @pranavrajaram, @rogers1000, and @tanho63 for their contributions and feedback on this release!

nflreadr 1.1.2

CRAN release: 2021-12-08

New Functions

  • nflverse_sitrep() and ffverse_sitrep() give a minimal overview of the package dependencies
  • Minimum R version bumped to R 3.6.0 - this is the minimum version required to read the current RDS file-version.
  • _sitrep() functions receive a small print-related bugfix and colouring improvement.

nflreadr 1.1.1

CRAN release: 2021-10-05

New Data and Functions

  • clean_player_names() and clean_team_abbrs() added - these help standardise player names and team abbreviations based on internal dictionaries.
  • load_ff_rankings() now has a type argument and can return "draft" or "week" rankings from the DynastyProcess/data repo.
  • clean_homeaway() converts a dataframe of games with columns prefixed with home_ and away_ to a dataframe of teams, renaming to team_ and opponent_ and doubling the rows.
  • Added load_pfr_advstats() which provides pass, rush, rec, def additional data for each week.

Bug Fixes

  • Add Rcpp and RcppParallel minimum dependencies to fix qs issues.
  • Added a message that reminds the user of the caching behavior. The message will be displayed once every 8 hours if the session is interactive.
  • Adjusted file location of snap count data

Thank you to @ajreinhard, @brunomioto, @jthomasmock, @mrcaseb, @SCasanova, and @tanho63 for their feedback and contributions to this package!

nflreadr 1.1.0

CRAN release: 2021-09-02

This release makes some backend changes for speed, reduced dependency footprint, and ease of maintenance.

New Data

  • load_player_stats() can now retrieve weekly summaries of kicking data by specifying the stat_type argument to be "kicking".
  • load_combine() retrieves NFL combine data (from PFR).

Backend Changes

  • Remove progress handling from *_from_url() family of functions and move responsibility to progressively() function decorator instead. See vignette for details.
  • Removed dependency on dplyr and purrr in favour of data.table - this hopefully improves speed and reduces the dependency footprint.
  • Uses rlang::arg_match0 instead of match.arg (uses rlang explicitly instead of implicitly as a dependency of memoise).

nflreadr 1.0.0

CRAN release: 2021-08-09

The goal of {nflreadr} is to efficiently load data from nflverse GitHub repositories, and features caching, optional progress updates, and data dictionaries.

At this time, it includes data from the following repositories:

This will hopefully provide a unified and reliable package for downloading nflverse data that can be extended to the rest of the nflverse and ffverse package families.

Special thanks to Seb, Ben, John, Lee, and Thomas for their contributions to the package and to the data pipelines that this package relies on 🎉