What is ggplot2-book.org?

Updated

ggplot2-book.org is the online, work-in-progress version of the 3rd edition of ggplot2: Elegant Graphics for Data Analysis, published by Springer. It is written by Hadley Wickham, Danielle Navarro, and Thomas Lin Pedersen. The site is best understood as a theory-and-details companion to ggplot2 rather than a recipe collection: its stated focus is explaining the Grammar of Graphics that ggplot2 uses and describing the full details of the system.

Who it is for

The book's own framing sets clear expectations:

  • Good fit if you already use ggplot2 and want to understand why it works the way it does, so you can tailor plots to your own needs.
  • Poor fit if you want a cookbook. The site explicitly says it is not a cookbook and "won't necessarily help you create any specific graphic that you need."

In other words, it teaches the underlying model, not a catalogue of finished charts.

What it covers

The site presents a table of contents as its main navigation, and the welcome text describes two layers of content:

Layer Description
Basics Some details on the fundamentals of ggplot2
Primary focus The Grammar of Graphics that ggplot2 uses, plus full details of the system

The authors also note that the Preface explains what changed from the 2nd edition, which is useful if you are migrating from the earlier book.

How to use it

  1. Open the table of contents and pick the chapter matching the layer you need — basics first, grammar and details after.
  2. Read the Preface if you have prior experience with the 2nd edition, to see what has changed.
  3. Treat each chapter as conceptual grounding, then apply it to your own plot rather than searching for a ready-made example.

Expected result: a working understanding of the grammar behind ggplot2, which you then use to build or adapt graphics for your own data.

Common sticking points

  • Expecting recipes. Because the book is not a cookbook, searching it for "how do I make chart X" may not give a direct answer. Use it to understand the components, then assemble the plot yourself.
  • Assuming it is finished. The site describes itself as a work-in-progress 3rd edition, so treat it as an evolving draft rather than a frozen reference.
  • Confusing it with the package documentation. This is a book about the grammar and details, not the API reference for individual functions.

Quick answer

If you want to confirm what the site is: it is the free online draft of the 3rd edition of the ggplot2 book by Wickham, Navarro, and Pedersen, published by Springer, focused on the Grammar of Graphics and the full details of ggplot2 — not a cookbook for specific graphics.