Skip to contents

The goal of futebolplotR is to provide functions and geoms that help creating visualization of Brazilian soccer related analysis. It provides a ggplot2 geom that does the heavy lifting of plotting Brazilian soccer badges in high quality, with correct aspect ratio and possible transparency.

The futebolplotR contains emblems of the teams that have participated in the Brasileirão Série A soccer league from 2003 to the present day. Other teams are also welcome!

This package can be used with data from brasileirao R package.

The code for this package was heavily based on nbaplotR with minor changes to support Brazilian soccer team badges.


You can install the development version of futebolplotR from GitHub with:

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

Using futebolplotR

The key function in the package is geom_futebol_badges() which will add Brazilian soccer team badges to a ggplot. Here you can see all the current available teams (currently 44) to plot.


team <- futebolplotR::valid_team_names()

df <- data.frame(
  a = c(rep(1:5, 8),c(1,2,3,4)),
  b = sort(c(rep(1:8, 5), c(0,0,0,0)), decreasing = TRUE),
  teams = team

ggplot(df, aes(x = a, y = b)) +
  geom_futebol_badges(aes(team_abbr = teams), width = 0.1) +
  geom_label(aes(label = teams,
                 color = teams,
                 fill = teams),
             nudge_y = -0.35)+
  scale_color_futebol(type = "secondary")+
  scale_fill_futebol(type = "primary")+
    plot.margin = margin(15,15,15,15,"pt")
  coord_cartesian(clip = "off")

For more information on using the package, check out our Getting Started article


This package was created by Bruno Mioto and Gabriela Junqueira. We thank Sebastian Carl for creating the nflplotR and nbaplotR packages, which were fundamental to the development of futebolplotR.