Skip to main content
HomeAbout RLearn R

How to Make a ggplot2 Histogram in R

Learn how to make a ggplot2 histogram in R. Make histograms in R based on the grammar of graphics.
Updated Feb 2023  · 15 min read


In this tutorial, we will be visualizing distributions of data by plotting histograms using the ggplot2 library in R. ggplot2 is the most popular plotting library in R, and it is part of the tidyverse library ecosystem. The library makes it easy to build great-looking and complex visualizations in an intuitive layer-building approach. You can learn how to make a histogram with basic R in a separate tutorial. 

Master your data skills with DataCamp

Learn the skills you need at your own pace—from non-coding essentials to data science and machine learning.

By continuing, you accept our Terms of Use, our Privacy Policy and that your data is stored in the USA.

Histograms are visualizations that show frequency distributions across continuous (numeric) variables. Histograms allow us to see the count of observations in data within ranges that the continuous variable spans.

Housing Data

We will first need to import the ggplot2 library using the library function. This will bring in all of the different built-in functions available in the ggplot2 library. If you have not already installed ggplot2, you will need to install it by running the install.packages() command. We will do the same for the readr library, which will allow us to read in a csv file, and dplyr, which allows us to work more easily with the data we read in. 


For this tutorial, we will be using this housing dataset which includes details about different house listings, including the size of the house, the number of rooms, the price, and location information. 

We can read the data using the read_csv() function. We can read it directly from the URL or download the csv file into a directory and read it from our local storage. The first attribute of read_csv() is the location of the data, and the col_select attribute allows us to choose the columns we are interested in. 

home_data <- read_csv(
    col_select = c(price, condition)

We can then look at the first few rows of data using the head() function 



How to Make a Histogram with ggplot2 

Now we can create the histogram. Regardless of the type of graph we are creating in ggplot2, we always start with the ggplot() function, which creates a canvas to add plot elements to. It takes two parameters.

  • The first argument is a data frame. Here we want to use home_data.
  • The second argument is a mapping from columns in the data frame to plot aesthetics. This mapping must call the aes() function. Here we map the price column to the x-axis.

So far, our code is

ggplot(data = home_data, aes(x = price))

This won't draw anything useful by itself. To make this a histogram, we add a histogram geometry using geom_histogram().

ggplot(data = home_data, aes(x = price)) +


Add Descriptive Statistics to Histogram Using geom_vline()

We can add descriptive statistics to our plot using the geom_vline() function. This adds a vertical line geometry to the plot.

First, we calculate a descriptive statistic, in this case, the mean price, using dplyr's summarize().

price_stats <- home_data |>
summarize(mean_price = mean(price))
# A tibble: 1 × 1
1    540088.

The function takes the xintercept parameter, and optional color and linewidth attributes to customize the color and size of the lines, respectively. We will add a mean line using the plus sign as we did in the previous section.

ggplot(home_data, aes(x = price)) +
    geom_histogram() +
    geom_vline(aes(xintercept = mean_price), price_stats, color = "red", linewidth = 2)

Notice that in geom_ functions, the mapping and data arguments are swapped compared to ggplot().


Plotting Probability Densities Instead of Counts

To add a probability density line to the histogram, we first change the y-axis to be scaled to density. In the aes() function, we set y to after_stat(density)

We can then add a density layer to our graph using the geom_density() function. Here we set the color attribute to green and the linewidth attribute to 2.

ggplot(home_data, aes(x = price, y = after_stat(density))) +
    geom_histogram() +
    geom_vline(aes(xintercept = mean_price), price_stats, color = "red", linewidth = 2) +
    geom_density(color = "green", linewidth = 2)


Notice that the numbers on the y-axis have changed.

As you are starting to see, the syntax for ggplot2 is simple but very powerful. We can add multiple layers on top of a simple graph to add more complexity to it with additive logic and some well-defined built-in functions.  

Update Binning Using Bin

We can update the binning of our ggplot2 histogram using the bin attribute. We set bin attributes equal to the number of bins we want to display on our graph. This will help us see more or less granular data in our histogram. 

ggplot(data = home_data, aes(x = price)) +
  geom_histogram(bins = 100)


We can also set the bin width manually using the binwidth attribute of geom_histogram().

ggplot(data = home_data, aes(x = price)) +
  geom_histogram(binwidth = 50000)


Finally, you can align the boundaries using the center or boundary attributes. If you want the boundaries of bins to fall on specific multiples, you can use these attributes (only one can be used at a time). To ensure bins end up on integer values, set the attribute equal to 1.   

ggplot(data = home_data, aes(x = price)) +
  geom_histogram(boundary = 1)


Customize the Color of the Histogram

In this section, we will change the colors of the histogram. We can customize the color of the outlines of each bar using the color attribute, and we can change the fill of the bars using the fill attribute of geom_histogram(). We will fill the bars with blue and change the outline color to white. 

ggplot(data = home_data, aes(x = price)) +
  geom_histogram(color = "white", fill = "blue")


Customize the Color of the ggplot2 Histogram Based on Groups 

You can customize the colors of the histogram bars. 

Changing the fill aesthetic (inside aes() the function) will change the interior colors of the bars based on the value of a variable in the dataset. That variable should be categorical (a factor) rather than integers, so we can convert it using the factor() function. For this example, we will look at the condition variable, a value ranging from 1 (bad condition) to 5 (great condition). 

home_data <- home_data |>
    mutate(condition = factor(condition))

ggplot(data = home_data, aes(x = price, fill = condition)) +


Add Labels and Titles Using Labs

Next, we add titles and labels to our graph using the labs() function. We set the x, y, and title attributes to our desired labels. 

ggplot(data = home_data, aes(x = price)) +
  geom_histogram() +
  labs(x ='Price (USD)', y='Number of Listings', title = 'Housing Price Distributions')


Setting x-axis Limits Using xlim()

We can set the x-axis limits of our plot using the xlim()  function to zoom in on the data we are interested in. For example, it is sometimes helpful to focus on the central part of the distribution rather than over the long tail we currently see when we view the whole plot. 

Changing the y-axis limits is also possible (using ylim()), but this is less useful for histograms since the automatically calculated values are almost always ideal.

We will zoom in on prices between $0 and $2M.

ggplot(home_data, aes(x = price)) +
    geom_histogram(bins = 100) +
    xlim(0, 2000000)


Change Legend Position 

If we want to move the legend on our graph, for instance, when we visualize the condition in different colors, we can use the theme() function and the legend.position attribute. The values that legend.position takes are “bottom”, “top”, “right”, or “bottom”. You can also pass the coordinates you would like the legend to be in using c(x, y).

ggplot(home_data, aes(x = price, fill = condition)) +
    geom_histogram() +
    theme(legend.position = "bottom")

Using Facets in ggplot2

Finally, we can visualize data in different groups in separate graphs using facets. This will split the visualization into several subplots for each category. This can be done using the facet_grid() function. We will visualize the distributions of prices by different condition values below. 

ggplot(home_data, aes(x = price)) +
  geom_histogram() +  facet_grid(vars(condition))

Faceting is covered in more detail in the Facets for ggplot in R tutorial.



To create a histogram in ggplot2, you start by building the base with the ggplot() function and the data and aes() parameters. You then add the graph layers, starting with the type of graph function. For a histogram, you use the geom_histogram() function. You can then add on other customization layers like labs() for axis and graph titles, xlim() and ylim() to set the ranges of the axes, and theme() to move the legend and make other visual customizations to the graph. 

ggplot2 makes building visualization in R easy. You can create simple graphs or more complex graphs, all while relying on the same simple additive syntax. It is the most popular graphing library in R.

Take it to the Next Level

ggplot2 is covered in depth in the Data Visualization in R skill track, beginning with Introduction to Data Visualization with ggplot2. You can learn to combine ggplot2 data visualizations with other tidyverse tools in the Tidyverse Fundamentals with R skill track. For a handy reference about everything you just learned, download a copy of the ggplot2 cheat sheet.


Learn more about R

Certification available

Intermediate Data Visualization with ggplot2

BeginnerSkill Level
4 hr
Learn to use facets, coordinate systems and statistics in ggplot2 to create meaningful explanatory plots.
See DetailsRight Arrow
Start Course
See MoreRight Arrow

Google Cloud for Data Scientists: Harnessing Cloud Resources for Data Analysis

How can using Google Cloud make data analysis easier? We explore examples of companies that have already experienced all the benefits.

Oleh Maksymovych

9 min

40 R Programming Interview Questions & Answers For All Levels

Learn the 40 fundamental R programming interview questions and answers to them for all levels of seniority: entry-level, intermediate, and advanced questions.
Elena Kosourova's photo

Elena Kosourova

20 min

A Guide to Docker Certification: Exploring The Docker Certified Associate (DCA) Exam

Unlock your potential in Docker and data science with our comprehensive guide. Explore Docker certifications, learning paths, and practical tips.
Matt Crabtree's photo

Matt Crabtree

8 min

Bash & zsh Shell Terminal Basics Cheat Sheet

Improve your Bash & zsh Shell skills with the handy shortcuts featured in this convenient cheat sheet!
Richie Cotton's photo

Richie Cotton

6 min

Functional Programming vs Object-Oriented Programming in Data Analysis

Explore two of the most commonly used programming paradigms in data science: object-oriented programming and functional programming.
Amberle McKee's photo

Amberle McKee

15 min

A Comprehensive Introduction to Anomaly Detection

A tutorial on mastering the fundamentals of anomaly detection - the concepts, terminology, and code.
Bex Tuychiev's photo

Bex Tuychiev

14 min

See MoreSee More