Skip to content
Coming soon: Ally. Your guide to the world of AI and R. Learn More →
R for the Rest of Us Logo

Fundamentals of R

Adding Text to Plots

Transcript

Click on the transcript to go to that point in the video. Please note that transcripts are auto generated and may contain minor inaccuracies.

View code shown in video
# Load Packages -----------------------------------------------------------

library(tidyverse)

# Import Data -------------------------------------------------------------

penguins <- read_csv("penguins.csv")

penguin_bill_length_by_island <-
  penguins |>
  group_by(island) |>
  summarize(mean_bill_length = mean(bill_length_mm, na.rm = TRUE)) |>
  arrange(mean_bill_length)

# Adding Text to Plots ---------------------------------------------------------

# Text is just another geom.
# We can use geom_text() to add labels to our figures.

ggplot(
  data = penguin_bill_length_by_island,
  mapping = aes(
    x = island,
    y = mean_bill_length,
    fill = island,
    label = mean_bill_length
  )
) +
  geom_col() +
  geom_text()

# Those text labels are too long!
# Let's create a new variable to use for plotting.
# We're using the number() function from the scales package
# to make this variable

library(scales)

penguin_bill_length_by_island_v2 <-
  penguin_bill_length_by_island |>
  mutate(
    mean_bill_length_one_digit = number(
      mean_bill_length,
      accuracy = 0.1
    )
  )

# Now let's plot using our new data frame

ggplot(
  data = penguin_bill_length_by_island_v2,
  mapping = aes(
    x = island,
    y = mean_bill_length,
    fill = island,
    label = mean_bill_length_one_digit
  )
) +
  geom_col() +
  geom_text()

# Note that we use mean_bill_length_one_digit for the label aesthetic property
# and mean_bill_length for y.
# If you use mean_bill_length_one_digit for both, your graph will
# look different.

penguin_bill_length_by_island_v2

ggplot(
  data = penguin_bill_length_by_island_v2,
  mapping = aes(
    x = island,
    y = mean_bill_length_one_digit,
    fill = island,
    label = mean_bill_length_one_digit
  )
) +
  geom_col() +
  geom_text()

# We can use the hjust and vjust arguments to horizontally and vertically
# adjust text.

# vjust = 0 puts the labels on the outer edge of the bars.

ggplot(
  data = penguin_bill_length_by_island_v2,
  mapping = aes(
    x = island,
    y = mean_bill_length,
    fill = island,
    label = mean_bill_length_one_digit
  )
) +
  geom_col() +
  geom_text(vjust = 0)

# vjust = 1 puts the labels at the inner edge of the bars.

ggplot(
  data = penguin_bill_length_by_island_v2,
  mapping = aes(
    x = island,
    y = mean_bill_length,
    fill = island,
    label = mean_bill_length_one_digit
  )
) +
  geom_col() +
  geom_text(vjust = 1)

# I often do something like vjust = 1.5 to give a bit more padding.

ggplot(
  data = penguin_bill_length_by_island_v2,
  mapping = aes(
    x = island,
    y = mean_bill_length,
    fill = island,
    label = mean_bill_length_one_digit
  )
) +
  geom_col() +
  geom_text(vjust = 1.5)

# We can adjust the color of the text using the color argument.
# We're putting it outside of the aes() because we are setting it
# for the whole layer.

ggplot(
  data = penguin_bill_length_by_island_v2,
  mapping = aes(
    x = island,
    y = mean_bill_length,
    fill = island,
    label = mean_bill_length_one_digit
  )
) +
  geom_col() +
  geom_text(
    vjust = 1.5,
    color = "white"
  )

# geom_label() is nearly identical but it adds a background.
# With geom_label() the color argument determines the text and border color
# while the fill is the background color.

ggplot(
  data = penguin_bill_length_by_island_v2,
  mapping = aes(
    x = island,
    y = mean_bill_length,
    fill = island,
    label = mean_bill_length_one_digit
  )
) +
  geom_col() +
  geom_label(
    vjust = 1.5,
    color = "white",
    fill = "black"
  )

Your Turn

# Load Packages -----------------------------------------------------------

library(tidyverse)

# Import Data -------------------------------------------------------------

penguins <- read_csv("penguins.csv")
			
# Adding Text to Plots ---------------------------------------------------------

# Copy your last code chunk. 
# Then add text labels on the top of each bar that show the number of penguins of each species.
# You'll need to use geom_text() and the vjust argument to do this.
# Make the text labels show up in red.

# YOUR CODE HERE

# Do the same thing, but use geom_label() instead of geom_text().
# This time, make the text itself show up in white.

# YOUR CODE HERE

Learn More

Data Visualization: A Practical Introduction has a section in Chapter 5 on adding text to plots, as does Chapter 11 of R for Data Science.

Information about using vjust and hjust is on the geom_label page of the tidyverse website.

Also, check out the ggrepel package , which automatically adjusts overlapping text and labels.

Have any questions? Put them below and we will help you out!

You need to be signed-in to comment on this post. Login.

Feiran Chen

Feiran Chen • March 25, 2026

Hi! I'm curious about when should I use |> and when should I use + ? Thanks!

Gracielle Higino

Gracielle Higino Coach • March 26, 2026

Hi Feiran! The |> operator gets something from its left side and feeds it into something on the right side. As a pipe, it serves to "flow" things through it. It usually means that the first argument of the function on the right side will be the result of the code on the left side.

The + operator makes an addition, and in the ggplot context, it adds layers to your plot. You start with a plotting area, then add the dimensions of your data, then the images that correspond to your data as you want to show it, then you apply a theme, etc.

There are situations where you might see both on the same code block: when the result of a certain code is fed directly into a plot as a dataset. You'd see something like this:

data |>
filter(column == "condition") |>
ggplot() +
geom_bar() +
theme()