Skip to contents

Load CFB team info from the data repo

Source: R/load_cfb.R
load_cfb_teams.Rd

Loads team information including colors and logos - useful for plots! This function wraps the cfbd_team_info() function sourced from the College Football Data API.

Usage

load_cfb_teams(fbs_only = TRUE)

Arguments

fbs_only

if TRUE, returns only FBS teams, otherwise returns all teams in the dataset

Value

A tibble of team-level image URLs and hex color codes.

See also

cfbd_team_info()

Issues with this data should be filed here: https://github.com/sportsdataverse/cfbfastR-data

Other loaders: load_cfb_pbp(), load_cfb_rosters(), load_cfb_schedules(), update_cfb_db()

Examples

# \donttest{
  try(load_cfb_teams())
#> ── Team information from CollegeFootballData.com ───────────── cfbfastR 2.3.0 ──
#> ℹ Data updated: 2026-08-19 18:01:21 UTC
#> # A tibble: 138 × 43
#>    team_id school   mascot abbreviation alt_name1 alt_name2 alt_name3 conference
#>      <int> <chr>    <chr>  <chr>        <chr>     <chr>     <chr>     <chr>     
#>  1    2005 Air For… Falco… AF           AF        Air Force NA        Mountain …
#>  2    2006 Akron    Zips   AKR          AKR       Akron     NA        Mid-Ameri…
#>  3     333 Alabama  Crims… ALA          ALA       Alabama   NA        SEC       
#>  4    2026 App Sta… Mount… APP          Appalach… APP       App State Sun Belt  
#>  5      12 Arizona  Wildc… ARIZ         ARIZ      Arizona   NA        Big 12    
#>  6       9 Arizona… Sun D… ASU          ASU       Arizona … NA        Big 12    
#>  7       8 Arkansas Razor… ARK          ARK       Arkansas  NA        SEC       
#>  8    2032 Arkansa… Red W… ARST         ARST      Arkansas… NA        Sun Belt  
#>  9     349 Army     Black… ARMY         ARMY      Army      NA        American …
#> 10       2 Auburn   Tigers AUB          AUB       Auburn    NA        SEC       
#> # ℹ 128 more rows
#> # ℹ 35 more variables: division <chr>, classification <chr>, color <chr>,
#> #   alt_color <chr>, logo <chr>, logo_2 <chr>, logos_3 <chr>, logos_4 <chr>,
#> #   logos_5 <chr>, logos_6 <chr>, logos_7 <chr>, logos_8 <chr>, logos_9 <chr>,
#> #   logos_10 <chr>, logos_11 <chr>, logos_12 <chr>, logos_13 <chr>,
#> #   logos_14 <chr>, logos_15 <chr>, logos_16 <chr>, twitter <chr>,
#> #   venue_id <int>, venue_name <chr>, city <chr>, state <chr>, zip <chr>, …
# }