ggplot2 theme_bw() in R: White Theme With Panel Border

theme_bw() applies a black-and-white theme to ggplot2 plots with a white panel background, light grey gridlines, and a full rectangular panel border. It is the internal base for both theme_classic() and theme_minimal(), and the standard choice for engineering reports and publication figures that need a visible plot frame.

theme_bw()                                                  # default bw theme
theme_bw(base_size = 14)                                    # larger text for slides
theme_bw(base_family = "serif")                             # serif font for papers
theme_bw(base_size = 11, base_line_size = 0.4)              # thinner grid + border
p + theme_bw()                                              # apply to existing plot
p + theme_bw() + theme(panel.grid.minor = element_blank())  # drop minor gridlines
p + theme_bw() + theme(legend.position = "top")             # override after base
theme_set(theme_bw())                                       # set as session default

What theme_bw() does in ggplot2

theme_bw() strips ggplot2's grey panel and replaces it with a white background, light grey gridlines, and a full rectangular black border around the panel. Axis ticks remain visible. The result resembles graph paper inside a thin frame.

It is one of seven complete themes in ggplot2 (theme_grey, theme_minimal, theme_bw, theme_classic, theme_light, theme_dark, theme_void). Internally, theme_bw() is the parent that theme_minimal() and theme_classic() both build on.

theme_bw() syntax and arguments

theme_bw() accepts four optional arguments that scale the entire theme proportionally. The defaults match the standard 6-by-4 inch ggplot2 figure.

The four arguments:

• base_size: numeric. Base font size in points (default 11). All text elements scale relative to this value.
• base_family: character. Base font family (default ""). Common values are "serif", "sans", "mono", or a registered custom font name.
• base_line_size: numeric. Base width for line elements (default base_size/22). Controls gridline and axis tick thickness.
• base_rect_size: numeric. Base width for rectangle borders (default base_size/22). Controls the panel border thickness, which is visible in theme_bw() (unlike theme_classic() and theme_minimal()).

Common theme_bw() patterns

These six patterns cover the everyday uses of theme_bw(). Each example shows how the theme adapts across scatter, bar, and faceted layouts.

1. Apply theme_bw() to a scatter plot

The grey panel disappears, a thin black border frames the plot area, and faint grey gridlines remain in the background. Axis ticks stay visible so readers can read values directly from the axes.

2. Scale up base_size for a slide

base_size = 16 enlarges every text element together. Gridlines and the panel border also scale via base_line_size and base_rect_size, keeping the visual weight balanced.

3. Drop minor gridlines for a cleaner look

The minor gridlines (the lighter pair between major ticks) add visual noise on small figures. Setting panel.grid.minor = element_blank() removes them while keeping the major grid for value lookup. This is the most common override applied on top of theme_bw().

4. Apply theme_bw() with faceting

theme_bw() ships with light grey strip backgrounds that match the panel border in tone. Faceted plots feel like a uniform grid of mini-figures rather than separate floating panels.

5. Use theme_bw() for an engineering report

Bumping base_rect_size to 0.7 draws a heavier border that survives black-and-white printing. Gridlines stay subtle because they scale with base_line_size, left at the default.

6. Build a custom theme on top of theme_bw()

theme_bw() vs theme_classic, theme_minimal, and theme_light

Pick the right base before customizing. The seven built-in themes each cover a different reader expectation; the wrong base means writing extra theme() overrides you did not need.

If you want the same grid but a softer frame, switch to theme_light() (light grey border instead of black). If you do not need the frame at all, switch to theme_minimal(). If readers should not see gridlines, switch to theme_classic().

Set theme_bw() as the session default

Call theme_set(theme_bw()) once and every later ggplot inherits it automatically. This avoids repeating + theme_bw() across a multi-figure report.

Reset with theme_set(theme_grey()) to return to ggplot2's default.

Common pitfalls when using theme_bw()

Pitfall 2: Gridlines disappear when you blank the panel. Setting panel.background = element_blank() on top of theme_bw() also hides the gridlines because they render against the panel layer. To keep grid but drop the fill, use panel.background = element_rect(fill = NA, color = NA) instead.

Pitfall 3: Border looks too heavy on small figures. The default base_rect_size works at 6-by-4 inches but feels thick on a tiny inset or a 2-by-2 panel. Reduce it with theme_bw(base_rect_size = 0.4) or override directly via theme(panel.border = element_rect(linewidth = 0.4)).

Pitfall 4: Custom font silently falls back. If base_family = "Times New Roman" still shows the default sans font, R cannot find the font on your system. Register it first with extrafont::font_import() or showtext::font_add(), or stick to safe values "serif", "sans", or "mono".

Try it yourself

Related ggplot2 themes and helpers

After mastering theme_bw(), explore its closest companions:

• theme_classic(), theme_minimal(), theme_light(), theme_void(): alternative built-in themes
• theme(): element-by-element customization for titles, gridlines, panel borders
• element_text(), element_line(), element_rect(), element_blank(): element constructors
• theme_set(): global default theme for every plot in the session
• ggthemes package: theme_economist, theme_few, theme_tufte built on theme_bw()

See the ggplot2 complete themes documentation.

FAQ

What is theme_bw() in ggplot2?

theme_bw() is a built-in ggplot2 theme that gives plots a white background, light grey major and minor gridlines, and a full rectangular black panel border. Axis ticks remain visible. It is one of seven complete themes in ggplot2 and the internal base that theme_classic() and theme_minimal() both extend. Use it when you want a bounded plot area with visible gridlines for value reads.

What is the difference between theme_bw() and theme_classic()?

Both use a white background and visible axis ticks, but theme_bw() keeps light grey gridlines and a full rectangular panel border, while theme_classic() removes both, leaving only the bottom and left axis lines. Pick theme_bw() for engineering reports that depend on the grid, and theme_classic() for journal submissions.

How is theme_bw() different from theme_minimal()?

theme_bw() keeps a full black panel border around the plot area; theme_minimal() drops the border. Both share a white background and light grey gridlines, but theme_minimal() also removes axis ticks. Choose theme_bw() when the figure needs a visible frame, and theme_minimal() when you want a lighter look without a bounding box.

How do I remove minor gridlines from theme_bw()?

Append theme(panel.grid.minor = element_blank()) after theme_bw(). The minor gridlines are the lighter pair drawn between major ticks; removing them is the most common manual override applied on top of theme_bw() because they often look noisy on small figures. To strip ALL gridlines (major and minor), use theme(panel.grid = element_blank()) instead.

How do I set theme_bw() as the default for every plot?

Call theme_set(theme_bw()) at the top of your script. Every later ggplot() call inherits the theme automatically. Reset with theme_set(theme_grey()) to restore the ggplot2 default. This is the standard way to enforce a consistent look across figures in a report.