Urban Institute Data Visualization Style Guide

This data visualization style guide helps the Urban Institute ensure a uniform look and feel across charts, graphs, and tables that appear in Urban publications and on the Urban website. This guide is intended for Urban employees and, as such, may include references and links to internal language and tools.

We have made this guide public in the hope of creating a resource for other nonprofit and research organizations and to benefit the wider data visualization community. We will update and expand this guide on an ad hoc basis depending on the changing needs of Urban staff members and evolving technologies, tools, and publication types. If you’re looking for the previous version of the Urban style guide, click here.

LAST UPDATED ON AUGUST 27, 2025

This site contains guidelines that are consistent with current data visualization best practices and design principles. It also reduces the burden of design and color decisions on individual researchers and analysts. These guidelines are primarily intended for charts, graphs, and tables that appear on the Urban website and in Urban (PDF) publications. There are minor sizing and typographic differences between visuals formatted for the web and those appearing in PDF documents and PowerPoint presentations, which we note throughout this guide.

The Urban Institute Excel Macro add-in and the Urban styles package for R (urbnthemes) are two open source tools Urban staff can use to more easily create and format their data visualizations for different publication types. Both tools automate much of the information in this guide, including applying formatting conventions for charts created in Urban style.

Table of Contents

  1. Chart Typography and Sizing
  2. Using the Excel Macro
  3. Inserting Figures into Urban Word Templates
  4. R Shiny, Tableau, and PowerBI Guidance
  5. Chart Parts
  6. Using Color in Urban Graphs and Charts
  7. Best Practices for Data Visualization
  8. Accessibility
  9. Considerations for Data related to Race, Ethnicity, and Gender
  10. Chart Examples
  11. Maps
  12. Tables

Chart Typography and Sizing

Good chart typography creates a hierarchy among elements and guides the reader through the visual. Urban uses a defined set of font sizes and styles to create this hierarchy.

Urban uses the Lato font for all our products, including the website, PDF publications, and presentations. A suitable replacement is the default Arial font. If Lato is not installed on your computer, contact the Tech and Data department.

The font sizes in Urban charts depend on whether the chart is produced for the web or within a PDF. The Excel macro and R theme apply the correct font sizes to both web and PDF figures.

Descriptive text — title, subtitle, sources, notes, and logo — are handled differently for web and print (PDF) products. For web products, all text is included in a single image (e.g., PNG) file. For print (PDF) products, descriptive text is placed directly in the Microsoft Word file and not the chart image. Data labels, axis labels, and other text used directly in the chart should be included in the chart image.

Font

Color

Case

PDF figures

Web figures

Figure number

Lato Regular

#0A4B69 or RGB(10,75,105)

ALL CAPS

8pt

11px

Title

Lato Black

#000000 or RGB(0,0,0)

Title (all major words capitalized)

12pt [inserted in the Word document, not the actual chart]

20px

Subtitle

Lato Italic

Black (#000000 or RGB(0,0,0))

Sentence (only the first word capitalized)

10pt [inserted in the Word document, not the actual chart]

16px

Axis titles

Lato Regular

Black (#000000 or RGB(0,0,0))

Sentence

8.5pt

12px

Axis labels

Lato Regular

Black (#000000 or RGB(0,0,0))

Sentence

8.5pt

12px

Data labels

Lato Regular

Black (#000000 or RGB(0,0,0))

Sentence

8.5pt

12px

Legend text

Lato Regular

Black (#000000 or RGB(0,0,0))

Sentence

9.5pt

14px

Source

Lato Regular

Black (#000000 or RGB(0,0,0))

Sentence

8pt

11px

Notes

Lato Regular

Black (#000000 or RGB(0,0,0))

Sentence

8pt

11px

Most of Urban’s charts will be full width (760px for web and 6.25” for PDFs). The main content width on the Urban website is 760px, which translates to approximately 125.83 characters in Excel. In PDF products, simple figures can be 3.13” wide, which is half the width of full-size figures.

^ table of contents

Using the Excel Macro

Urban has created an add-in for Microsoft Excel that automatically applies Urban colors, chart formatting, font styling, and font sizes to Excel figures. This set of instructions will show you how to install and use the add-in.

Download the Urban Institute Excel macro here. Download the WorkRise macro here and the Tax Policy Center macro here.

Installing the add-in on PC computers

  1. Download the Excel add-in from the Brand Identity Guidelines intranet page: Your Urban > Templates > Excel > “Excel add-in for creating Urban style charts.”
  2. Save the file to your computer. You can put the file anywhere, but placing it directly in the Excel AddIn folder is preferred. On Urban PC computers, the add-in folder is most likely located on the D drive at: D:\Users\USERNAME\AppData\Roaming\Microsoft\AddIns\. (USERNAME is your username on the computer. On other computers, the folder may be in the C: drive in the same subdirectory.)
    1. If you can’t locate the AppData subdirectory, you can use Excel’s built-in Themes menu to help you locate it. Under the Page Layout tab, select the Themes button. At the bottom of that menu, select “Save Current Theme.” Excel will bring you to the Document Themes folder, which is in D:\Users\USERNAME\AppData\Roaming\Microsoft\folder. You can copy the folder location from the top of that window, paste it into your Windows Explorer folder, and navigate to the AddIn folder from there.
    2. To navigate to this AddIn folder location, you may need to unhide the AppData subdirectory. To do so, open a Windows Explorer window, click Tools, then View. You can now select “Show hidden files, folders, and drives” under the “Hidden files and folders” option.
  3. Regardless of whether you saved the file to your AddIn folder or to another location on your computer, you can now install the add-in. To do so, select the File tab in the ribbon.
  4. At the bottom of the File window, select Options.
  5. In the Options window, select the Add-Ins option near the bottom of the left pane, and then select the Go... button at the bottom of the larger window.
  6. At this point, a menu will load. If you saved the add-in file to the “AppData” folder location, the add-in should already be listed. You can simply check the box and select OK. If you saved it anywhere else, select Browse… and navigate to the location where you saved the UrbanGraphingStyle.xlam file. (Excel may ask if you’d like to place the add-in into your Roaming folder; it is fine to select OK here.) Select OK.
    1. SECURITY NOTE: If the ribbon tab does not appear after installing the add-in (this typically happens in a later session), it may be due to a security update from Microsoft. A detailed description of how to solve this issue can be found here.

Installing the add-in on Mac computers

  1. Save the add-in to a location on your computer.
  2. Under the Tools menu in the top toolbar, select the Excel Add-Ins... option.
  3. Select Browse… and navigate to the UrbanGraphingStyle.xlam file. Select Open. The box next to the UrbanGraphStyle add-in should now be checked. In this smaller menu, select OK. You will now see the Urban Graph Styles tab in your Excel ribbon. The tab will appear every time you open Excel.

Using the add-in

  1. Select the data you want to use to create your chart.
  2. Click the chart option from the Urban Graph Styles menu that matches the style of your chart.
  3. A pop-up box will appear asking if you want to format your graph for Web or Print (the Cancel option will close the dialog box). An Urban-formatted version of your chart will appear.
  4. Edit the x-axis title and y-axis title or delete them if the units are already specified in the chart title or subtitle.
  5. Edit any corresponding data cells to fix wording and capitalization as needed. Your edits should automatically appear in the chart.
  6. To export your chart:
    1. On PC computers, use the Export menu in the add-in. You can choose a folder location and file type as you would for any other software tool.
    2. On Mac computers, the Export menu does not exist. Instead, copy the chart (Command-C), open the Preview tool, and open a new file (Command-N). Save the chart (Command-S) and use the drop-down menu to change the file format to PNG. In the resulting menu, change the Resolution to 600 (pixels/inch). Name the file and click Save.

^ table of contents

Using the R Urban Theme

urbnthemes is a set of tools for creating Urban Institute–themed plots and maps in R (the theme has been tested against ggplot2 version 3.0.0; it will not function properly with older versions of ggplot2). The package extends ggplot2 with print and map themes as well as tools that make plotting easier. A comprehensive set of examples is available at the Institute R Users Group website.

library(urbnthemes) makes ggplot2 output align more closely with this style guide, but it does not produce publication-ready graphics. Visual styles must still be edited using your project’s normal editing workflow. Exporting charts as PDFs rather than image files (e.g., PNG, JPEG) will allow them to be edited more easily.

Run the following code to install or update urbnthemes:
install.packages("remotes")
remotes::install_github("UrbanInstitute/urbnthemes")

Run the following code at the top of each script:
library(tidyverse)
library(urbnthemes)
set_urbn_defaults(style = "print")

A comprehensive review, installation instructions, and more details and tutorials about using R at Urban and the urbnthemes package can be found in the Urban Institute R Graphics Guide.

^ table of contents

Inserting Figures into Urban Word Templates

Urban Microsoft Word templates have built-in formatting to ensure correct placement of figures. To insert a figure—either as an Excel graph or as an image exported from another tool like R—follows these steps:

  1. Start with the most recent Word template for your product, which can be downloaded from Urban Explorer on the Publications Templates intranet page. Delete the sample column chart.
  2. For each figure, copy and paste the figure template text from the figure number through the notes line (see image below). This will automatically apply the built-in styles to the text around the figure.
  3. Write out the figure number, title, and subtitle (delete the subtitle if needed) directly in the Word file (not in the Excel graph or image).
  4. Place your cursor directly before the ‘U’ in ‘Urban Institute’ and then paste your figure, choosing either “Use Destination Theme and Embed Workbook,” “Use Destination Theme and Link Data,” or “Paste Special … Microsoft Office Graphic Object.”
  5. Write out the Source and Notes beneath the figure.
Detailed image showing the text, size, and format for a figure in an Urban Institute report written in Microsoft Word.

^ table of contents

R Shiny, Tableau, and PowerBI Guidance

Urban staff use a variety of data analytics and visualization tools in their work. When it comes to R, interested users should consult the public-facing R tutorials available on the Urban Github site and consult the R User Group for additional resources. We recommend that Urban staff consult with the Data Visualization team for additional support related to obtaining Tableau and PowerBI licenses and creating graphs or dashboards with these tools.

Public-facing, high-visibility data visualization tools and dashboards published at Urban are built with custom tools and undergo a full design and build process to ensure that products hit the highest accessibility, UI, and mobile-friendly design standards—all with Urban’s wider audience in mind.

COMM and the Tech and Data Science teams are developing guidance on R Shiny, Tableau, PowerBI, and other off-the-shelf dashboarding tools for use at Urban. Our intake processes are connected for this kind of tooling request.

Currently, only the R Shiny tool is approved for specific use cases. Our consensus is that R Shiny dashboards can be appropriate for highly niche audiences (e.g., other researchers or select funders), with review and input from COMM’s Design and Data Visualization teams.

These products are not embedded on Urban’s website. Rather, our guidance is to screenshot and link to them, as seen in this Data at Urban post and this Urban Wire post. These guidelines are evolving and subject to change.

^ table of contents

Chart Parts

Key elements of Urban charts are as follows:

  • The chart should be referenced in the text.
  • Titles use headline/title case, and subtitles use sentence case; all titles are left aligned.
  • All text within the figure uses sentence-style capitalization.

In all Urban products, researchers should reference charts and tables in the text to provide context for the data. Figures and tables should be placed immediately after the paragraph that references them. If the chart consists of a limited number of values, consider a couple sentences of text to explain the data in lieu of an image.

Urban charts require a title, source line, and axis or other labels identifying the elements and units of the chart. This can be achieved by using some combination of a subtitle, axis titles, axis labels, data labels, and legend (not all elements will be necessary for every figure). Urban charts posted on the web also include an Urban tagline/logo in the lower-right corner of the figure so that when others copy and paste our charts, Urban is identified as the source.

For Excel charts produced for the web, add the title, subtitle, source, and notes directly in the Excel chart. Because Excel’s chart title and subtitle fields are limiting in terms of formatting, we use a regular text box for all the text at the top of the graphic, as well as for the source and notes text at the bottom.

In charts produced for PDF publications, add the title, subtitle, sources, and notes as text directly in the Microsoft Word file. Axis titles, labels, and the legend are added in Excel or in the R chart space directly.

On the web

Detailed image of a graph showing all the text sizes, type, size, color, and position of all text in an online graph from the Urban Institute.

In print (for PDFs)

Detailed image of a graph showing all the text sizes, type, size, color, and position of all text in a PDF graph from the Urban Institute.

The chart parts are described in detail below.

  • Titles: Use headline case for titles and sentence case for subtitles. Keep them short and simple. Try to explain the chart in a few words and draw conclusions where possible. Use a subtitle to add qualifiers or further clarification. The unit of measurement should be mentioned only once, either in the subtitle or the y-axis label. For example, instead of a purely descriptive title, such as “Labor Force Participation Rate, Men and Women, 1950–2024,” a more active title would be “The Labor Force Participation Rate Has Declined for Men and Increased for Women.” Subtitles can be used to denote specifics about the data, such as time periods, frequency, units, or geography.
  • Axis titles and labels: Use sentence-style capitalization for all text within the figure, including axis titles, data labels, and legends. In sentence-style capitalization, the first letter of the sentence and any proper names (including program names) are capitalized, and all other text is set in lowercase. For example, “Percentage of total funding,” “2021 operating expenses,” “Denver Regional Transportation District,” and “$50,000 and above.” You can use abbreviations in the axis titles and labels as long as the abbreviations are defined in the notes.
  • Source: The source line should contain the source of the data for the figure and include full publication information, including the authors, title, and publication date, all in Urban’s notes citation style. All figures in Urban publications should have a source line. If the source of the data is Urban analysis, the source line can read “Authors’ analysis.”
  • Notes: The notes line can include technical information about methodology, statistical explanations, and notes that apply to certain values. The notes should also define all acronyms and abbreviations used within the figure, using this format: “FPL = federal poverty level.” Notes that apply to certain cells in tables should use superscript letters as note references. Asterisks should only be used to indicate significance levels (e.g., p < 0.001, * = significant at 0.001 level).
  • Legend: Stretch legends across the top of the chart between the title/subtitle and y-axis label. Order the series in the legend in a logical way, mirroring the order of the data in the chart. When possible, directly label the data in the chart and omit the legend.
  • Data labels: Chart elements can be labeled to provide readers with the specific data values or additional context. Data labels should match the units of the chart and be placed as close as possible to the actual data point (e.g., top or inside a bar on a bar chart or a point on a line chart). Explanatory labels should be concise and explain important, surprising, or interesting aspects of the graph.
  • Tagline: The Urban tagline is built from standard text using Lato Bold, 9pt, black, small caps, with 0.5pt of expanded character spacing. The word “Urban” is colored blue (RGB[22,150,210] or #1696d2) and “Institute” is black (RGB[0,0,0] or #000000). The Excel add-in automatically includes the tagline for web graphs. For PDF products, the tagline is added as text in the Microsoft Word file at the bottom right of the figure, with no spacing between the figure and the tagline. The tagline is omitted in government-funded products.

^ table of contents

Using Color in Urban Graphs and Charts

Urban's main colors are cyan, gray, and black. Yellow and magenta are used as secondary colors throughout the new Urban brand. In general, yellow and magenta should be used sparingly; these colors are best for highlighting purposes, such as when drawing attention to a certain category or indicating a trend line. Tertiary colors for graphics include space gray, green, and red, and should be used infrequently.

When selecting colors for charts and graphs, first consider the type of data you are presenting. Usually, data for visualizations can be grouped into one of four main groups: categorical, sequential, diverging, or binary (see next sections for examples in the Urban color palette).

  • Categorical palettes are best to distinguish discrete chunks of data that do not have an inherent ordering (e.g., race, state of residence).
  • Sequential palettes are appropriate when data follow a certain order, such as when data range from low to high (e.g., poverty rates, unemployment rates). The typical approach is to use light(er) colors for low(er) values and dark(er) colors for high(er) values.
  • Diverging palettes are used to distinguish values that vary from a central value, such as the average, median, or zero. Diverging palettes will use a neutral color for the central value, such as white or gray, and then employ a sequential color palette in either direction. For example, a sequential palette for changes in per capita gross domestic product might be centered at zero with a white color, then range to dark yellow for negative values and to dark blue for positive values. The center of the diverging palette should always be labeled to avoid confusing the reader.
  • Binary palettes are a subset of categorical palettes and are used to distinguish between two distinct groups, such as Republicans and Democrats. When comparing data on binary gender groups, do not use blue to represent men and pink to represent women. Instead, choose a color combination such as yellow and cyan or another combination of our main graphic colors.

For more information about the subtleties of color and choosing colors for your data visualizations, refer to Datawrapper's blog post "A detailed guide to colors in data vis style guides” and Nightingale magazine's blog posts on the subject.

Color combinations

Urban’s core color palette consists of eight main colors, ordered below in a hierarchy from core colors to less commonly used colors. All Urban tool sets, including the Excel add-in and color palette, and the urbnthemes R package, follow this hierarchy.

Specific shades of each main categorical color are found below for use in graphs that require sequential and diverging palettes. It should be noted that tints and shades of colors in the Excel add-in and color palette do not exactly match these colors.

The palettes below offers multiple options for combining colors in Urban charts, though only the combinations shown in the first set of each section are included in the Excel add-in and R theme. When in doubt, individuals are encouraged to consult the Urban Design and/or Data Visualization teams for assistance in choosing color combinations.

Main graphic colors


Text and contrast

Urban Institute data visualizations should strive to meet Web Content Accessibility Guidelines (WCAG) to make web content most accessible to people with disabilities. (Read more about those international standards here and in the Urban Institute report Do No Harm Guide: Centering Accessibility in Data Visualization). Urban follows WCAG 2.0 Level AA guidance to ensure that background color and text pairings maximize contrast.

The color palettes below contain the correct white or black text to pass the WCAG AA ratings for contrast at smaller text sizes (18px or less).

Shades of main colors

var colors=["#CFE8F3","#A2D4EC","#73BFE2","#46ABDB","#1696D2","#12719E","#0A4C6A","#062635"];

var colors=["#F5F5F5","#ECECEC","#E3E3E3","#DCDBDB","#D2D2D2","#9D9D9D","#696969","#353535"];

var colors=["#FFF2CF","#FCE39E","#FDD870","#FCCB41","#FDBF11","#E88E2D","#CA5800","#843215"];

var colors=["#F5CBDF","#EB99C2","#E46AA7","#E54096","#EC008B","#AF1F6B","#761548","#351123"];

var colors=["#DCEDD9","#BCDEB4","#98CF90","#78C26D","#55B748","#408941","#2C5C2D","#1A2E19"];

var colors=["#D5D5D4","#ADABAC","#848081","#5C5859","#332D2F","#262223","#1A1717","#0E0C0D"];

var colors=["#F8D5D4","#F1AAA9","#E9807D","#E25552","#DB2B27","#A4201D","#6E1614","#370B0A"];


One group

For one color group, grey should not be used as it loses focus while magenta draws attention


Two groups

Categorical

Use blue and red sparingly, usually only when comparing political data.

Sequential


Three groups

Categorical

Sequential


Four groups

Categorical

Use yellow and magenta sparingly, usually only for highlighting data.

Sequential


Five groups

Categorical

Sequential


Six Groups

Categorical

Sequential


Seven Groups

Categorical

Sequential


Eight Groups

Consider consolidating categories or breaking up the chart. Eight groups is really too many.

Diverging

var colors=["#CA5800","#FDBF11","#FDD870","#FFF2CF","#CFE8F3","#73BFE2","#1696D2","#0a4c6a"];

^ table of contents

Best Practices for Data Visualization

Data visualization is a mix of science and art. There are some basic guidelines and best practices rooted in our understanding of cognitive psychology, statistics, and human-computer interaction, but these also reflect preferences for different colors, typefaces, layouts, and more.

What Is the Right Chart for Your Data?

Stop! Should it even be a chart?

Although charts are great for communicating data, they are not the appropriate tool for every situation. If you find explanatory sentences do a better job of distilling the information you want to convey, consider going without a chart. If your main goal is to present detailed information as opposed to showing patterns, or if it’s important that the reader can accurately determine the values of your data, consider using a table instead. You may also find that simply including a single, large number (commonly known as “big aggregate numbers”) may be sufficient. In these cases, inserting a simple text box or shape in your PowerPoint or Word document will work.

Selecting the appropriate chart type for your data and the message you want to convey is critical to creating a successful data visualization. The table below offers guidance on what types of charts are best suited for different purposes. However, this is not an infallible set of choices, because there is not a one-to-one relationship between data types and graph types; for example, a vertical bar chart can be used to compare categories or show changes over time. The list below should therefore be viewed as a starting resource to guide the graph creator. If you are unsure, reach out to the Data Visualization team to help explore your options.

I want to...

Compare values or rankings

Show trends or change over time

Depict a part-to-whole relationship

Show deviation from a reference point

Show the distribution of values

Creating Effective Charts

The list of best practices provided here is a set of guidelines derived from years of work, research, and experience.

Keep it simple. Don’t try to stuff every data value into a single graph. This doesn’t mean you need to strip out all your data, but consider what you want your reader to come away with. You might be able to include all your data and highlight a subset of values. For example, consider a line chart with all 50 US states—you could use gray for the majority of states and add color to just the few you want to highlight.

Be consistent. Once you’ve chosen blue to represent one group in one chart, make sure all other charts in your publication or slide deck use blue to represent that group as well. This consistency makes reading and comprehension easier for your reader.

Small multiples. The small multiples approach is exactly what it sounds like: create a series of smaller graphs positioned in close proximity. Breaking a single larger, complex graph into smaller pieces can not only make a complex graph easier for readers to comprehend but also help create a sense of movement by aligning changes over time in a particular order.

There are two primary guidelines to follow when creating a small multiples visualization. First, each multiple should be the same type, shape, and size and use the same type of scales, which should start and end at the same values. The best way to think about small multiples is to take a single, dense graph and break it up into many charts—in other words, the framing elements of the chart should not change. Second, try to order the small multiple graphs in a meaningful way—for example, by some value, geographic location, or even alphabetically.

Highlighting. Highlighting can call attention to specific data points in very dense charts. The observations you want the reader to focus on should be rendered in a color that helps them stand out (usually pink or yellow at Urban), while the rest of the series are in a different color (usually blue, black, or gray). However, be selective with your use of color to highlight specific values, series, or observations, because too many colors can make it difficult to pick out the values on which you want your reader to focus.

Reference lines. There may be times when you want to include a reference line or pointer for a specific event, threshold, or benchmark. In such cases, make sure that your line is measured precisely. For example, if you are marking June 2010 in a line chart, the reference line should be located halfway between 2010 and 2011.

Titles. Use active, concise titles. For example, instead of a purely descriptive title, such as “Labor Force Participation Rate, Men and Women, 1950–2019,” a more active title would be “The Labor Force Participation Rate Has Declined for Men and Increased for Women.” Subtitles can be used to denote specifics about the data, such as time periods, frequency, units, or geography.

Annotation. Annotation is one of the most important ways to improve your data communication efforts. There are two primary ways to annotate your visualizations. First, adding explanatory text within the graph itself can highlight specific values or explain content. Second, you can add a layer of annotation to explain how to read the graph. This approach can be especially useful for readers who may not be familiar with a particular graph type. For example, you could add a pointer that denotes how the values get larger or smaller along each axis in a scatterplot.

Data labels and markers. When possible, avoid using legends and instead directly label the data on the graph. Endeavor to evenly space and align the labels instead of scattering them around the graph, which can make it difficult for your reader to find the label and risks emphasizing one series or data value over another. On a line chart, for example, you might place the labels at the far right of the graph, slightly outside the graph space, but left-aligned.

Marking outliers. Data values that are significantly different from others in your dataset may be considered outliers. In some sense, the statistical definition of an outlier is not necessarily important; a data value(s) may simply look like an outlier when plotted in your graph, which may require some explanation. Be careful with outliers, however; they can signify an interesting result or finding, but they may also indicate that something is wrong or mismeasured in the data.

Showing uncertainty. Visualizations that depict distributions or uncertainty may be inherently difficult for many readers who are not familiar with the underlying data or statistical concepts. It is therefore important to clearly explain when certain data are missing or if there is uncertainty around certain estimates.

There are various kinds of data uncertainty. One form of uncertainty stems from randomness in the data. Small samples are a prime example of this kind of uncertainty. Consider a political poll that gives candidate Smith a 54 percent approval rating with a margin of error of plus or minus 4 percentage points. The poll has uncertainty because the dataset is only a sample of people who responded to the survey.

Another form of uncertainty comes from inaccurate, untrusted, imprecise, or unknown data. In some cases, we would be unable to address the uncertainty because we aren’t aware of it. In other cases, we could say our data are imprecise because, for example, it’s measured at an aggregate level; for example, infants’ ages captured in months rather than weeks.

Urban takes both kinds of uncertainty seriously, and researchers are best equipped to assess whether their data are unreliable. But knowing when to visualize different kinds of uncertainty is a different task and often depends on the knowledge and statistical sophistication of your reader.

Stay away from 3-D. There is no need to add a superfluous third dimension to your chart, particularly when you don’t have a third value. The 3-D effect available in many software tools actually distorts the data values because the effect is not actually 3-D but rather a perspective rendering of 3-D.

Be careful with data transformations. Log scales or other transformations can be useful for depicting rates of change or to address large outliers. The obvious trade-off is that many readers will not understand what a log transformation is and what it means. For example, everyone can understand what $150,000 of income means, but a logged value of 5.18 is not familiar to many readers. However, log scales can be an appropriate choice when the rate of change is more meaningful than absolute values.

Data Visualization Absolutes at Urban

The Urban Institute is committed to exploring and expanding how we create and engage audiences and readers through our visual display of information. While the practice of data visualization is a mixture of art and science with ample opportunity for creativity, there are certain data visualization practices that we avoid.

  • Nonzero baselines. The axis in bar charts (whether vertical or horizontal) should always start at zero. The gaps between bars are overemphasized when the value axis starts at something other than zero. When small differences between bars are important to show but a zero axis makes those differences difficult for the reader to see, consider adjusting the data to show percent change, difference, or some other similar adjustment. It is important to note that other charts types that do not use length or height as the primary encoding—including, for example, scatterplots and line charts—do not necessarily need to start at zero.
  • Dual axis charts. Charts that have two axes—where one series is tagged to one axis and another series is tagged to another, parallel axis—should be avoided. These kinds of charts are confusing, difficult to read, and are often misleading. There are several possible solutions to creating a dual axis chart, including multiple graphs (arrayed either horizontally or vertically); showing the percent change or another normalization; or using a different chart type such as a connected scatterplot. (There are two exceptions to this rule: charts that show the translation of a single measure such as Fahrenheit and Celsius temperatures; and the Pareto chart, which shows individual values as bars and a line showing the cumulative sum.)
  • Pie charts with too many slices. This advice is purposely left unclear. There is no specific “rule” about how many slices are too many slices in a pie chart, but the general recommendation is to keep the overall number of slices in pie charts to fewer than 5. Humans cannot easily compare differently sized slices in pie charts, which reduces the effectiveness of the chart itself. In general, pie charts are best used when the slices of interest are values that generate right angles, which are familiar shapes, namely 25% and 75%, or a straight vertical line through the chart, namely 50%. While there may be exceptions to this guidance, Urban style is to avoid pie charts that have too many slices and are therefore difficult to understand.
  • Avoid too many categories. While the Urban color palette offers several hues and multiple tints and shades, our standard is to keep the number of categories in any graph to fewer than seven. Stacked bar/column charts, pie charts, line charts, and other charts with seven or more series/colors will look cluttered and be difficult to read. In these instances, fewer series or several multiple charts may be a better solution.

^ table of contents

Accessibility

It’s important to consider how people with different impairments and disabilities access online content. Many people rely on screen readers to navigate the internet. (Screen readers are tools used by blind people, people with low vision, and people with learning disabilities who consume text in audio formats.) When a screen reader passes by content on the screen, including file names, titles, and headings, it reads this content out loud. Ensuring that content will work with screen readers is a large part of making a document accessible. Some of the primary issues we’re concerned with when we talk about accessibility are hearing issues, vision issues, color blindness, ability, cognition, neurodiversity, and learning disabilities. Not all the conditions are permanent—consider, for instance, how you would use a computer if you were to break your arm.

To create accessible content, Urban follows the guidelines laid out in Section 508 of the Rehabilitation Act of 1973. Section 508 requires US federal government agencies to develop, procure, maintain, and use information and communications technology that is accessible to people with disabilities. We also follow some of the recommendations and guidelines from the Web Content Accessibility Guidelines. Some federal agencies that fund Urban work have agency-specific accessibility requirements that we are asked to follow.

Data visualization creators can do several things to create accessible charts and tables:

Write alt text

  • Screen readers can only communicate information via text. To meet accessibility requirements, all nontext items in a web product require “alternative text” (alt text), or a written description that communicates visual content. All Urban website content must have alt text for charts, tables, and images. All Urban PDF products asked to meet 508 accessibility requirements must also have alt text, but alt text is not otherwise required for images in Urban PDF products.
  • Urban researchers are responsible for writing alt text when it is required. It is often easier to write alt text as you create your figures rather than at the end of the writing process. Engaging with Urban’s Disability Affinity Group may be one way to seek advice on writing good alt text or, more generally, creating accessible content.

Below, we share some guidance on writing from the MacArthur Foundation and a blog post by Amy Cesal:

  • Alternative text should present the content and function, not necessarily a description, of an image. If you had to remove the image, what text would you put in its place?
  • If an image is decorative, such as a header image on a blog or cover image on a report, or the alternative text is provided in nearby text, then the image should have empty alternative text (some tools have an option for “blank” or “empty”). If this is not an option, leave the field blank. You should not put empty spaces, empty quotes (except in HTML alt=""), or any other nonsense information in these fields.
  • Avoid words like “picture of,” “image of,” or “link to.”
  • Use the fewest number of words necessary. Less than 160 characters is ideal for search engine optimization.
  • Avoid phrases like “click here,” “here,” “more,” “more information,” “read more,” and “continue.” Instead, use descriptive text that informs a user of the link destination.

Meet color contrast requirements

Urban’s color palette has been tested to meet accessibility requirements. If you are working with an agency or group that requires additional accessibility considerations, please contact the Data Visualization or Design teams. You can also consider adding additional encodings to your visualizations, such as hashmarks, stripes, or other patterns. This style guide promotes clean design and graphs that are free of extraneous colors, but when communicating data to readers with accessibility needs, additional encodings may be important.

Web Content Accessibility Guidelines (WCAG) 2.0 Level AA requires the contrast ratio of the luminance (think: brightness) of two colors to be 4.5:1 for normal text and 3:1 for large text. A higher level of contrast (Level AAA), requires a contrast ratio of 7:1 for normal text and 4.5:1 for large text. Large text is defined as 14 point (typically 18.66px) and bold or larger, or 18 point (typically 24px) or larger. Text standards also apply to text in graphics, such as data labels in a chart or text boxes in a logic model.

Please note that the Urban blue used in Urban Word templates does not meet color contrast requirements for headings. If you are producing an Urban PDF product that needs to meet 508 accessibility requirements, the editorial team has 508-compliant Word templates that use Urban dark blue to meet contrast requirements.

Avoid merged cells in tables

Tables are possibly the most difficult aspect of working with 508 accessibility standards. Tables that meet accessibility requirements cannot have any merged cells, blank cells, blank rows, or blank columns, as screen readers have a difficult time with spanner headings and blank cells. To meet 508-accessibility requirements, tables need to be stripped of spanner headings so that every column has a separate heading. This can be a tedious and time-consuming process. If you know you are producing a product that needs to be 508 compliant, it can be helpful to design tables that have no spanner headings from the start.

Use built-in Word styles in Urban Word templates

Manual formatting that creates tabbed indents for paragraphs, line spaces between paragraphs, and arbitrary heading styles is not accessible, as it creates extra characters that screen readers will read. Urban Word templates have built-in styles that apply proper line spacing, paragraph indents, and heading hierarchy without relying on manual formatting. Urban’s built-in styles also cover table and figure formatting to ensure that proper line spacing and styles are applied to figure and table numbers, titles, subtitles, and notes. Built-in styles also allow us to apply the correct formatting and spacing to table elements, including column headings, row headings, table rows, and table text. Using these styles rather than manually applying formatting will help meet accessibility guidelines for line spacing, headings, and color contrast. You can apply Urban Word styles using the Styles Pane in Word, and/or your editor will review and apply these styles during the editing process. For PDF products that need to meet 508 accessibility requirements, use the 508-compliant brief or report template, which has additional accessibility formatting built in.

Write in plain language

Government agencies follow plain language guidelines to meet the Plain Language Act of 2010. In cases where Urban products must meet plain language requirements, the Urban Editorial team can conduct a plain language edit in addition to a copyedit. But even if your product does not need to meet plain language requirements, adopting some principles of plain language can help your readers better understand your charts and tables.

  • Use active voice in titles and labels. Urban style is to use concise, active titles that tell the reader what they are supposed to learn and take away from the graph. Active titles help tell the story of your graph.
  • Make sure to explain all chart parts. Your chart or table should have enough information that it can be understood out of context of the rest of your document. Make sure titles, labels, legends, and notes provide enough information to tell the full story of your data. Your target audience should be able to navigate your chart, even if they don’t have a technical background.
  • Reduce jargon. Think about your audience and decide whether the terms that are familiar to you as a researcher will be understood by your readers. Aim to be as clear as possible and try to replace complicated words and phrases with more direct language. If a technical term is necessary to include but may not be understood by all your readers, define it!
  • Omit needless words. With charts and tables, space is at a premium. Identify phrases that can be rewritten to be more concise.

Additional guidelines and strategies can be found in Urban’s Do No Harm Guide: Centering Accessibility in Data Visualization and the following Urban editorial resources: “508 Compliance Process” and “508 Accessibility Basics.”

^ table of contents

Considerations for Data Related to Race, Ethnicity, and Gender

The Urban Institute’s mission is to open minds, shape decisions, and offer solutions. To advance that goal, we must think intentionally about how we can learn from and speak to audiences that reflect the rich diversity of US communities, and we must foster a culture where employees from different backgrounds and perspectives enjoy mutual respect, inclusivity, and collegiality.

Urban’s efforts around diversity, equity, and inclusion (DEI) are reflected in our hiring and promotion practices as well as in our published work. With every data project, Urban researchers have an opportunity to carefully consider the language they use to describe people and groups and how to visually present data about these groups to readers, users, and audiences, including the communities that participate in or are affected by our research.

Choosing language related to people and demographic groups

Urban editorial style does not prescribe language for the terms used to describe people. Instead, we encourage research teams to consider using language and terms that are inclusive and respectful of the people they describe. (See Urban’s DEI toolkits, a collection of reference guides for creating respectful and inclusive products.) Urban editors encourage researchers to choose terms mindfully and to use these terms consistently and appropriately throughout a research product, including in the titles, labels, and annotations of tables and graphs.

In some instances, Urban researchers may choose to use the same terms used in an underlying data source, such as the racial categories used by the US Census Bureau. In other cases, researchers may choose to deviate from those terms. Researchers may want to consider including a footnote explaining their language choices related to the people and groups in their research and, if appropriate, why these language choices mirror or deviate from the terms used in an underlying data source. (This footnote only needs to appear once in an Urban publication and is usually placed at the first instance of a term; it does not need to be repeated in the notes for each table and figure.) There are example footnotes in many of the DEI toolkits.

Choosing the order for groups in charts and tables

Many graphs and tables encode data by demographic group. Graph producers should take an active role in choosing how to order and present data values for different groups. Urban does not have universal rules about ordering demographic data in visuals, but a few considerations can help you make decisions about order:

  • Is there a quantitative relationship or ordering between groups in your data?
  • Is there a particular story or relationship you are trying to visualize? If so, the order or presentation of results should reflect that story.
  • Is there a basic way to sort the results, such as by population size or sample size (weighted or unweighted), alphabetically, or by magnitude/effect of the results?
  • Are groups ordered in a particular way in the underlying data, and is it appropriate to match that order in your chart or table?

Choosing colors for groups of people

Follow the Urban color palette to select colors for the groups in your dataset. Urban tries not to use color palettes that reinforce gender or racial stereotypes (e.g., pink for women and blue for men). Furthermore, researchers should avoid using colors associated with skin tones. Using standard Urban colors will avoid such issues.

Additional guidelines and strategies can be found in Urban’s Do No Harm Guide: Applying Equity Awareness in Data Visualization.

^ table of contents

Chart Examples

The following examples use the Urban style and color guidelines to illustrate common chart types in Excel. To deconstruct any example, download the Excel Example Files file. The Excel add-in and the R theme will replicate (or closely replicate) these styles but may still require some additional manual edits. Over time, this list will grow to include more graph types and additional guidance.

Excel examples file

Horizontal and Vertical Bar Charts ^

In the Excel parlance, bar charts that are oriented vertically are called “column charts” and bar charts that are oriented horizontally are called “bar charts.” Both versions use a rectangle (or bar) as the core attribute to visualize the data. We use the term “bar charts” below to refer to both orientations.

When to use a bar chart (horizontally- or vertically-oriented)

  • To compare numerical values for different observations.
  • To show relative amounts.
  • To break one numerical variable out into different subgroups with grouped or stacked bars or columns.
  • To show changes over time for a relatively small number of time points.

Style tips

  • Avoid 3D bars or columns.
  • The y-axis should start at zero (there are a few instances when it is okay for the y-axis not to start at zero), but with few exceptions, Urban style is to start all bar charts at zero.
  • The width of the bars should be about twice the width of the space between the bars (use the Gap Width format area in Excel).
  • If all the bars measure the same variable, make them all the same color. Using different colors is an unnecessary element on the chart. When directly labeling the bars, consider eliminating the horizontal gridlines and y-axis labels as they add unnecessary elements to the chart.
  • Sequential series can be shaded from lightest to darkest for easy comparison.
  • To differentiate subsets of data, projections, or averages, consider using a different color shade or gray.
  • Legends should be stretched across the top of the chart and the order of the legend entries should match the order in the chart.
  • When data labels are included—typically just outside the ends of the bars—Urban style is to omit y-axis labels and gridlines (see examples below).
  • In the second graph below, notice the use of the black color for the bar measuring the “Overall” results to differentiate it from the other categories. Also notice the alphabetical ordering of racial groups. For alternative sorting strategies for demographic data, see the Urban Institute’s Do No Harm Project.
  • The text box for Sources and Notes may need to be adjusted manually to fit all of the text. For web graphics, Urban style is to try to align the top of that text box with the Urban logo.
Horizontal bar chart showing the share of state and local direct general expenditures across nine categories with the elementary and second education category highlighted in yellow.
 
Vertical bar chart showing the student loan delinquency rate in areas with majority racial or ethnic groups. The chart shows that predominantly American Indian and Alaska Native, Black, and Hispanic communities are disproportionately burdened by student debt
 

When to use a horizontal bar chart specifically

  • Horizontal bar charts are especially useful when long labels would make the text vertical or oddly-oriented in a vertical bar chart.
  • When using a horizontal bar chart, right-align the category labels and center them vertically with the respect to the bar.
  • Same styling decisions for vertical bar charts apply to horizontal bar charts.

Paired Bar Charts

When to use a paired bar chart
  • When you want to compare different groups or show the change in the composition of groups over time, but the data is not in a continuous time series.
  • To display the part-to-whole relationship of categories, as well as totals.
  • Relative to stacked bar charts (see next section) where some series do not sit on a consistent horizontal baseline, this version makes it easier to see the change in individual series across categories. It is also easier to compare series within the same category, allowing a better visual understanding of the part-to-whole relationship of any one data point.
  • In cases where large values hide some of the variation for smaller values, consider using more than one chart.
Paired horizontal bar chart that shows projected increases in poverty rates if the Social Security trust fund were depleted. The data show that poverty rates people of color would increase the most.
 

Stacked Bar Charts

When to use a stacked bar chart
  • When you want to compare different groups or show the change in the composition of groups over time, but the data is not in a continuous time series.
  • To display the part-to-whole relationship of categories, as well as totals.
Style tips
  • Again, the axis in a bar chart should always start at zero.
  • In a single chart, avoid plotting too many series—more than five or six—because too many categories generate a confusing picture.
  • Sequential series can be shaded from lightest to darkest for easy comparison.
  • Order the segments of the chart in a logical fashion. It is easier for readers to compare values for the series that sits directly on the horizontal or vertical axis—because the baseline doesn’t change over time. Thus, that series should either be (a) the most important series or (b) the series with the largest values.
    • That decision, however, should not override a logical ordering of the data, for example, age groups or educational attainment groups.
Stacked horizontal bar chart that shows how the share of gender-race groups in transit leadership varies across the country.
 
Stacked vertical bar chart that shows how most tenants are not reporting rents, but those with lower credit scores are more likely to do so.
 

Dot Plots ^

A dot plot is a graph type that uses dots or other shapes to represent individual data points along a single axis. Each dot corresponds to a value, and the dots are typically connected by a line or arrow. Dot plots are especially useful for comparing categories or groups, displaying distributions, or emphasizing individual points rather than aggregate values.

When to Use a Dot Plot

  • To compare different groups or show the change between two different points in time.
  • As an alternative to paired bar charts; dot plots can make it easier for readers to make comparisons.

Style Tips

  • Dot plots should generally be limited to two dots per group or observation; more than two can make the graph difficult to read. In addition, if the order of the dots differs between groups, readers can find dot plots difficult to navigate.
  • When using a dot plot to show change over time, consider using an arrow to help illustrate the direction of the change instead of a line.
  • Labels can be added to the side, above, below, or even inside the dot. And while this chart type is named “dot plot,” the “dots” can be squares, icons, emojis, or other shapes.
Two-paneled dot plot showing how the 2021 update to the Thrifty Food Plan narrowed the SNAP benefits gap for millions of families.

Source
Alternative 2


Line Charts ^

When to use a line chart

  • To show the trend in one or more metrics, usually over time.

Style tips

  • When possible, directly label the data series. If the lines are too close together or the labels are too long, a horizontal legend below the title is preferable.
  • Avoid individual data markers for long time series. In the example below, data markers are added because the lines are essentially parallel.
    • When data markers are included on a line chart, Urban typically uses circles.
    • Urban style does not define a specific number of data points or lines to determine when data markers should be included.
  • In a single chart, try to keep the maximum number of lines to no more than five or six. Plotting too many lines on the same chart can be confusing and clutter the message.
    • An important exception is the case where you may want to plot a lot of lines but only add color (and/or change the line thickness) to specific lines. For example, the graph below shows the annual poverty rate for all 50 states and Washington, DC for the 2008-2021 period, but highlights the lines for the areas with the biggest declines (Delaware, Washington, DC, and Idaho). In such cases, the other lines can be made a thinner and in a lighter gray color while the three areas of interest made slightly thicker and in Urban colors.
    • This can be more easily done using the “Start With Gray” option in the Urban Excel add-in tool.
  • When necessary, legends should be stretched across the top of the chart and the order should match the order of the lines in the chart.
  • As noted above, avoid dual axis line charts whenever possible. In such cases, consider another chart type, such as two separate line charts or a connected scatterplot.
Line chart that shows how second-lien debt rose since 2001 after more than a decade of decline, but still remains smaller than levels before 2008.
 
Line chart showing poverty rates for all 50 US states and Washington, DC. Delaware, Washington, DC, and Idaho saw the largest declines over the period and are shown in color while the other states are shown in gray lines.
 

Sparklines ^

Sparklines are small line charts, typically embedded in a table at the end of a row or column.

When to Use Sparklines

  • To visualize trends or changes without taking up much space.

Style Tips

  • Marking the first, last, highest, and/or lowest points in a sparkline can direct the reader’s attention or highlight key data points.
  • Creating sparklines in Excel is quite easy (Insert > Sparklines), but they tend to look blurry when exported. Consider using other tools like Datawrapper or R.
Table that shows the share of homeowners with a mortgage in 1989 and 2022 across six different age groups. A set of small line charts shows the trend over the entire period.

Slope Charts ^

A slope chart is a useful alternative to a paired bar chart, which requires readers to make multiple comparisons simultaneously (level and difference between and within groups).

When to Use a Slope Chart

  • To show before-and-after comparisons in a straightforward way.
  • To compare two values, not just changes over time. These charts are typically called “parallel coordinates plots” but, structurally, they are identical to slope charts.

Style Tips

  • Because a slope chart shows only two data points, the data shown should either (a) only be available for those two years or (b) be monotonically moving in that direction. You wouldn’t want to use a slope chart (or a paired bar chart, for that matter) to show a downward trend when the true data show an increase and then a decrease.
  • Colors can be used in multiple ways in a slope chart: individual color for each line, gray for several lines and color to highlight certain lines, or one color for groups that are increasing and another for groups that are decreasing.
  • At times, slope charts are better made taller than in the standard Urban size dimensions. Consider working with the data visualization team to make that determination.
  • The example below shows how converting the stacked vertical bar to a slope chart provides a different perspective of the data and facilitates easier comparisons between the two categories.
Stacked vertical bar chart that shows the distribution of health insurance coverage across five categories for nonelderly noncitizens and the total nonelderly population in 2024.

Source

Line chart that shows the distribution of health insurance coverage in 2024 across five categories for nonelderly noncitizens on the left side and the total nonelderly population on the right side.

Area Charts ^

When to use an area chart

  • To show a trend in composition of a group or groups over time.
  • To display the part-to-whole relationship of categories, as well as totals.
  • When you want to compare different groups or show the change in the composition of groups over time, but the data is not in a continuous time series, consider using a stacked a column chart.

Style tips

  • Basic guidance is to start the vertical (y-) axis at zero for area charts. While there is some debate about this recommendation, Urban views it as a starting point that can be altered with additional discussion.
  • When possible, directly label the series. If space is an issue, consider adding them off to the right of the graph, preferably matching the color of the data series. If the labels are too small or there are too many data series, use a legend positioned horizontally along the top of the chart.
  • In a single chart, avoid plotting too many series—more than five or six—because too many categories generate a confusing picture.
  • Sequential series can be shaded from lightest to darkest for easy comparison.
  • Order the segments of the chart in a logical fashion. It is easier for readers to compare values for the series that sits directly on the horizontal axis—because the baseline doesn’t change over time. Thus, that series should either be (a) the most important series or (b) the series with the largest values.
  • When plotting time years (e.g., years) along the x-axis, the typical approach is to use round numbers in intervals of one, two, five, or ten. Custom labels can be added when using round increments but would end on an odd year. For example, an axis extends from 2000 to 2024 and shows increments in every five years; in this case, a custom label could be added for 2024 at the end of the graph.
    • When using round increments are difficult to fit in the graph, consider using abbreviations for the dates, such as “’90” for annual data or “Jan 1990” for monthly data.
  • In the graph below, notice the use of “Trillions of dollars” in the subtitle area to define the y-axis labels, rather than writing out the full number with all of the zeros.
Blue area chart that shows US federal debt grew from around $50 billion in 1940 to more than $32 trillion in 2023.
 
Stacked area chart showing the share of active home sales have become more expensive between 2016 and 2024.
 

Gantt Charts ^

At its core, a Gantt chart is a type of bar chart where each bar represents a task, with the start and end points indicating the beginning and completion of the time period. At Urban, Gantt charts often appear in project proposals to record different phases of a research project.

When to Use a Gantt Chart

  • To plan or track project timelines, showing tasks, durations, and dependencies.
  • To visualize schedules, progress, and overlapping activities in project management.

Style Tips

  • In project proposals, filling the cells in a table built in Microsoft Word or Excel can be a sufficient Gantt chart.
  • Organize tasks logically: group related tasks and arrange them in chronological or priority order for easy navigation.
  • Gantt charts can be extended by modifying the width of the bars to denote another variable, such as the budget for each task.
Table showing 12 tasks in the rows across 16 months in the columns, from September 2024 to December 2025. Certain cells are filled in blue or yellow to denote when each task is being conducted.

Pie Charts ^

When to use a pie chart

  • Use pie charts when you want to show the relative relationship between a relatively small number of slices. It can be difficult for readers to accurately discern the values when there are more than 5 or 6 slices in the chart.
  • One strategy to make legible pie charts with many categories is to aggregate smaller values into an “other” or “miscellaneous” category.
  • If accuracy is a paramount concern, consider using a bar chart or another chart type.
  • Keep in mind that increments of 25° create right angles (and a straight line down the center of the chart) are more familiar to readers.
  • The typical alignment is to start the graph at 12 o’clock and have the slices rotate clockwise from largest to smallest. An exception to this standard is when the series follow a logical order, such as age group.
  • It's helpful to directly label each slice. Relying on a key requires the reader to do too much work to shift their eyes from one spot to another.
  • Pie charts should always add up to 100 percent.

 
Pie chart with four segments showing that states and localities fund half of US transit; federal funds account for 7 percent and fares, fees, and direct taxes account for the remaining 43 percent.

Treemaps ^

A treemap is an alternative to a pie or donut chart for displaying hierarchical or part-to-whole relationships. A key advantage of a treemap is its ability to show categories within categories, allowing readers to see how individual values contribute to larger totals.

When to Use a Treemap

  • To show hierarchical or part-to-whole data as nested rectangles, emphasizing proportions between parts and the whole.
  • As a useful alternative to a pie chart or donut chart.

Style Tips

  • Colors can be used to distinguish different groups in the treemap or to capture a second variable such as change (e.g., blue squares for rectangles that have increased over time and yellow squares for those that have decreased).
  • Labeling can be difficult in a treemap because of the compact space; consider using logical abbreviations and spelling them out in a note below the chart.
Rectangular treemap showing the distribution of federal employment in fiscal year 2022 across three broad categories: civilian, military, and government entreprises.

Source


Unit and Waffle Charts ^

A unit chart is a graphic in which individual objects or shapes represent individual data values. A waffle chart is a specific class of unit charts where the objects or shapes are arranged in a 10x10 grid, so each object represents a single percentage point. Unit charts have been criticized as forcing the reader to implicitly count the number of objects or shapes in the chart. Yet, they can be a useful way to engage readers.

When to Use a Unit or Waffle Chart

  • To display percentages or proportions in a grid of small, equal-sized units, making the part-to-whole relationship easy to understand.

Style Tips

  • Unit/waffle chart labels can be placed inside or to the side of the shapes.
  • Arrange shapes in a way that reflects the data naturally—typically left-to-right or top-to-bottom—to make interpretation intuitive.
  • The unit value should be easily accessible and intuitive to the reader, such as a whole number. Setting a “unit” to some arbitrary value, like 2.6 percent, forces the user to conduct unnecessary mental math.
  • Limit the number of categories in unit charts; too many categories can create clutter.
Set of six unit charts showing the different state and territory priority policies—such as guaranteeing or subsidizing certain groups—in 2022.

Source

Four waffle charts showing the racial makeup of different types of businesses: adult-owned businesses, employer firms, employees, and sales.

Source


Scatterplots ^

A scatterplot displays individual data points on a two-dimensional graph. Each point represents an observation in the dataset and is positioned according to two variables: one on the horizontal axis and one on the vertical axis. Scatterplots are commonly used to show relationships or correlations between the two variables, such as whether they move together (positive or negative correlation) or if there's no clear pattern. They are especially useful for identifying trends, clusters, and outliers in data.

When to Use a Scatterplot

  • To show the relationship or identify patterns or trends between two variables.
  • To help detect clusters, groupings, or outliers in the data.

Style Tips

  • Good annotation helps people understand how to read a scatterplot. Depending on the audience, you may need to add annotations that describe how to read the graph along with annotations or labels that help the reader understand the graph’s content. For example, you might label the direction of each variable along each axis or clearly define the area above and below a best-fit line.
  • Labeling the data points in a scatterplot can be difficult: too many labels and the plot looks cluttered, too few labels and the plot looks unclear and confusing. Here are some strategies for deciding how and which labels to include:
    • Are there specific points readers will want to identify? For example, in a blog post about housing prices in Washington, DC, it might be valuable to label the point for DC in a scatterplot of housing prices for major US cities.
    • Are there obvious questions readers are going to ask about specific points? For example, it might make sense to label specific outliers or groups of points that are clustered together.
  • Scatterplots typically use circles to place the data on the graph, but other shapes are possible.
  • Scatterplots can be extended by sizing the markers by another variable (called a bubble scatterplot or bubble chart) and/or adding colors to the markers to represent another variable.
  • Best fit or regression lines should be used sparingly and, unless they are a central focal point of the graph, should be only slightly darker than the gridlines.
A scatterplot showing the relationship between the 2012-2022 percent change in medical debt along the vertical axis and the percent change in Herfindahl-Hirschman Index along the horizontal axis. The weakly positive correlation shows that counties with rising hospital market concentration had larger increases in medical debt prevalence.

Source


Bubble Charts ^

Bubble charts are an extension of a scatterplot where the size of the bubble represents the third variable.

When to Use a Bubble Chart

  • To help identify patterns, clusters, or outliers in multivariable data.

Style Tips

  • Circles should be sized by area, not by diameter.
  • Consider using color to encode a fourth variable.
  • Best fit or regression lines should be used sparingly and, unless they are a central focal point of the graph, should be only slightly darker than the gridlines.

Source


Connected Scatterplots ^

In a standard scatterplot, each dot within the x–y space represents a unique observation, such as a county, state, or country. A connected scatterplot modifies this format by using dots to represent points in time and connecting them chronologically. This type of chart offers an alternative to plotting two time series on the same axis and is a clearer substitute for dual-axis line charts, which Urban does not publish.

When to Use a Connected Scatterplot

  • To show the relationship between two variables over time in a single graph, emphasizing how they change relative to each other.
  • To highlight trends, cycles, or shifts in paired data points.

Style Tips

  • Good annotation is key to helping readers navigate a connected scatterplot. Evidence is mixed on whether and how such annotation works, and whether casual readers fully understand such graphs.
  • Connected scatterplots often end up looking jumbled and complex. In these cases, alternative approaches, like using two charts or normalizing the trends to a percentage change or index, often work better.
Scatterplot showing the change in the relationship between the unemployment rate along the horizontal axis and the job vacancy rate along the vertical axis. The first segment, during the financial crisis, moves downward from the top-left to the bottom-right of the graph, thereafter moving back up towards the top-left part of the graph.

Source


Heatmaps ^

A heatmap is useful for visualizing large datasets like correlation matrices or geographic data distributions.

When to Use a Heatmap

  • To show data density or magnitude using color gradients, making it easy to identify patterns, correlations, or anomalies.

Style Tips

  • Choose an appropriate color scale, whether sequential (i.e., light to dark) or diverging (i.e., light to dark in two directions from a midpoint).
  • Sort the data logically (e.g., by value, alphabetically, or chronologically) to make patterns clearer and easier to read.
  • Heatmaps typically do not include data labels, but that is not a rule.
Table showing which states have designated disaster funds as of 2019, the amount of those funds in dollars, and the level of FEMA funding that would have been at risk in 2019. The last column shows the difference between the state and FEMA funding levels and is shaded in light blue for small differences to dark blue for large differences.

Source


Beeswarm Charts ^

The beeswarm is a useful way to illustrate the distribution of your data by showing each data point.

When to Use a Beeswarm Chart

  • To display individual data points in a way that avoids overlap, making it clear where data clusters and spreads occur.

Style Tips

  • If combining multiple groups into a beeswarm chart, sort the groups logically to help make the patterns clearer and easier to read.
  • Too many data points will make the graph difficult to read and negate its purpose.
  • Consider adding key annotations and labels to help explain the data. For example, use labels to describe outliers or important values.
  • Use color to differentiate groups or values within the beeswarm.
Chart with hundreds of dots showing the percent of Black non-Hispanic households in a housing choice voucher program among public housing agencies with and without homeownership voucers.

Source


Box-and-Whisker Plots ^

The box-and-whisker plot is a summary graph type showing select percentiles in the distribution. It is useful for showing easily understandable numbers—for example, the largest and smallest or means and medians.

Keep in mind that some readers may be unfamiliar with statistical concepts (e.g., percentiles) and measures of uncertainty (e.g., confidence intervals). And, if it is important to show more aspects of the underlying data distribution, other chart types, like histograms or beeswarm charts, may be a better choice.

When to Use a Box-and-Whisker Plot

  • To summarize the distribution of data, showing medians, quartiles, and potential outliers.

Style Tips

  • Sort the data logically (e.g., by value, alphabetically, or chronologically) to make patterns clearer and easier to read.
  • Be sure to define each point—e.g., 1st and 99th percentile or 10th and 90th percentile—in the plot.
Set of box-and-whisker plots that shows how land-use boards overrepresent white residents relative to the local population by showing different percentiles of the distribution of boards that are white.

Source


Fan or Confidence Interval Plots ^

A fan or confidence interval chart is often used in forecasting or predictive modeling. Keep in mind that this chart shows select percentiles or confidence levels and that some readers may be unfamiliar with these statistical concepts.

When to Use a Fan/Confidence Interval Plot

  • To display uncertainty or variability around a central estimate.

Style Tip

  • Use color to visualize the move from higher levels of statistical confidence to lower levels. Typically, the values closest to the central estimate are the darkest, and the colors lighten as the values move outward.
Line chart that shows actual and projected gross domestic product between 2010 and 2027 where the projection years are shown with an set of blue areas denoting greater statistical uncertainty

Source


Histograms ^

A histogram groups values into bins, highlighting the frequency of occurrences. It can be useful for identifying patterns such as skewness, modality, or outliers in a dataset. The key consideration when creating a histogram is the number of bins to use; there is no “right” number, but there are statistical tests that can provide guidance.

When to Use a Histogram

  • To visualize the distribution of continuous data while highlighting the frequency of occurrences.

Style Tips

  • Use color transparency when overlaying histograms to help readers see where the distributions overlap.
  • Ridgeline charts can be used when layering together multiple histograms.
Vertical bar chart showing the distribution of the number of participants searching for housing by number of days from housing orientation to move-in.

Source


Strip Charts ^

The strip chart is a variation on the beeswarm chart that jitters (i.e., slightly adjusts or shifts the position of the data points in a controlled way) many data points to make them all visible.

When to Use a Strip Chart

  • To show individual data points along a single axis, sometimes with a slight jitter to avoid overlap.

Style Tips

  • Use semi-transparent dots (with solid outlines) to help visualize overlapping data points. This makes denser areas appear darker, highlighting patterns or clusters.
  • Some of the points in a strip chart may overlap and may thus be obscured, but that will also make the pattern darker so that it becomes clearer where the bulk of observations lie in the distribution.
Strip charts showing the relationship between the opt-in rate and the absolute error across eight different demographic characteristics.

Source

^ table of contents

Maps

There are obvious advantages to plotting geographic data on a map—people can find themselves and their communities, they can see the pattern across a state or country, and they are generally familiar to readers. However, one should approach the desire of creating a map with skepticism and critical thought. Is a map the best way to present geographic data? Or is the map simply showing where people live? Does it show interesting relationships to explore or simply relying on the fact that a map can be familiar to readers?

Whether to create a map and which kind of map to use will depend on two questions: How important are the geographic patterns in the data? And how important is it for the reader to see a familiar map?

A longer version of this section—along with Urban-specific guidance on creating maps in Excel, Datawrapper, and R—can be found at the Code@Urban Github page.

Should you use a map to visualize your data?

The overarching challenge with creating data-driven maps is that the familiarity of the map does not necessarily accurately represent the data being plotted. Take, for example, the US presidential election. What matters in the election is the number of electoral votes for each state, which directly corresponds to the number of people living in the state, not the state’s land area. So, for example, Wyoming, Idaho, and Montana are more than 325,000 square miles of the country and currently have 11 electoral votes. Massachusetts, by comparison, is about 7,800 square miles or less than 2.5 percent of the other three states, but itself also has 11 electoral votes. To address this imbalance between land size and the importance of the geography in the data, cartograms are one alternative to the standard maps.

Cartograms reshape geographic areas based on the data values. They might use differently-sized circles or squares for each state, or similarly-sized shapes to correspond to data elements. In his book Cartography, Kenneth Field summarizes the purpose of cartograms:

The intent of most thematic maps is to provide the reader with a map from which comparisons can be made, and so geography is almost always inappropriate. This fact alone creates problems for perception and cognition. Accounting for these problems might be addressed in many ways such as manipulating the data itself. Alternatively, instead of changing the data and maintaining the geography, you can retain the data values but modify the geography to create a cartogram.

Map Projections

There are myriad maps to choose from to create a data visualization. Geographic units on a map (e.g., states or counties) can be colored differently (i.e., “choropleth maps”) or can include different shapes such as dots or lines. Furthermore, there are hundreds of different map projections to choose from, all of which are attempting to take the three-dimensional spherical shape of the earth and flatten it to two dimensions.

Depending on the purpose and content, maps should use different projections. US maps for print publication, or use in Urban reports should use the Albers Equal Area projection. Simple interactive county-level or state-level maps also typically use the Albers projection. Zoomable tile-based interactive maps, on the other hand, tend to use the Mercator projection.

Different Kinds of Maps

Once you have decided that a map is the best solution for your data, the next question is what kind of map are you going to create? Urban typically produces three kinds of maps:

  • Choropleth maps. A map that uses colors, shades, or patterns on geographic units to show proportionate quantities and magnitudes.
  • Tile grid maps. A map that uses a single square for each geographic unit to approximate the shape of the overall geography. There are variations on the tile grid map, such as hex grid maps (which use hexagons for each geographic unit) and Demers cartograms (which use differently sized squares for each geographic unit).
  • Point-based maps. Maps that use dots or other shapes to mark specific locations or show quantities on a map or, in the case of dot density maps, use such shapes to indicate an overall pattern of distribution.
Two maps, both showing the US poverty rate by state using a blue sequential color palette. The map on the left is a standard choropleth and the one on the right is a tile grid map.

A secondary, but also important, question to consider when creating a map is how to choose the intervals (or bins) that will shade or define the geographic units. Placing data into discrete categories is, at its core, an aggregation problem. By combining several states or counties into a single bin, the reader cannot clearly distinguish how different the values are from one another.

There are four primary binning methods for maps:

  • No Bins. Essentially a continuous color palette (or “ramp”) in which each data value receives a unique color tone.
  • Equal Interval Bins. In this approach, the data are divided into equally-sized groups, such as 1-25, 26-50, 51-75, and 76-100.
  • Data Distribution Bins. Instead of having a bin at equal intervals, the bins can be arranged to hold the same number of observations, such as quartiles or quintiles.
  • Arbitrary Bins. Here, the map creator chooses the bin cutoffs based on round numbers, natural breaks, or some other arbitrary criterion.
Four different binning methods for maps: continuous, equal interval, quantile, and arbitrary.

Map Colors

Maps should follow the same basic rules as other graphics when it comes to colors. Choropleth maps, or maps that show the magnitude of a variable, should normally use the blue sequential color ramp.

Sometimes, a map needs to display change in a positive and negative way. In those cases, a diverging color palette works best. When using a diverging palette, be sure to clearly label the midpoint.

var colors=["#CA5800","#FDBF11","#FDD870","#FFF2CF","#CFE8F3","#73BFE2","#1696D2","#0a4c6a"];

Special palettes are sometimes required for specific projects or use cases. In such instances, contact the data visualization and design teams to work towards a solution.

var colors=["#761548", "#AF1F6B", "#E46AA7", "#EB99C2","#BCDEB4", "#98CF90", "#408941","#2C5C2D"];

^ table of contents

Tables

Tables are a unique form of visualizing data because, unlike many charts and graphs, they are not usually intended to give a quick, visual representation of data. Instead, tables are useful when you want to show the exact values of your data or estimates. They are not the best solution if you want to show a lot of data or if you want to show the data in a compact space. A well-designed table can help your reader find specific numbers and discover patterns and outliers.

Urban Styles

As with Urban charts, Urban tables follow style guidelines for font styles, font sizes, number formatting, number alignment, and cell/row/column shading. Each of these components has specific styling guidelines that make Urban visualizations look specific and consistent. Formatting differs slightly for PDF and web tables, as listed below. When built in Excel, tables are generally structured as shown below.

Tables for PDF Products

For tables that appear in Urban Word templates — which can be found on the Urban intranet — the built-in Urban styles will automatically apply the correct formatting. You can use these styles as you create tables, or your editor can apply the styles during the editing process. The default styles in Word can be found in the Home > Styles tab of the ribbon.

Table size and formatting

  • Tables should be full width, which is 6.25 inches in PDF products, with the following exceptions:
  • Smaller tables can be 3.13 inches or 4.69 inches (i.e., 50 or 75 percent of the page width)
  • Tables on landscape pages, such as in an appendix, can be 8.67 inches (100 percent of the page width)
  • Tables should have no empty columns or rows. The built in Urban styles will automatically apply the appropriate line spacing between table rows.
  • Urban style uses a 1pt black border beneath all column headings and the last row in a table. The default Urban style is to use no borders within a table; however, if needed, column or row borders can be used to increase readability. The style of (vertical) column borders is 1 pt, black. The style of (horizontal) row borders is 1 pt, round dot, and a color of 217 217 217 (light gray).

Table Text Styling for Urban Reports

Title

  • Headline capitalization, e.g., “Would Rolling Up Programs Conflate Different Outcomes?” rather than “Would rolling up programs conflate different outcomes”?
  • Keep text concise and use active voice
  • Figure/Table Title style (see list below)

Subtitle

  • Subtitles are optional in Urban tables and figures and can be used to list units or add contextual information. Keep text concise and use active voice.
  • Sentence capitalization (first word and proper nouns capitalized)
  • Figure/Table Subtitle style

Column headings

  • Use sentence capitalization for all column headings except for spanner headings, which use headline capitalization. Set supra-spanner headings in small caps.
  • Use spanner headings for units of measurement that apply to multiple cells. (Unless your document must be 508-compliant, in which case avoid using spanner headings altogether).
  • Table Column Heading style to all column headings and spanner headings.

Row headings

  • Use row headings when contextual information applies to more than one row.
  • Table Row Heading style (row subheadings use the same style)

Cell contents

  • All cell data should be decimal aligned
  • Where possible, keep similar cells to similar widths, making exceptions to accommodate lengthy cells or column headings
  • Data cells should be aligned bottom right
  • Text cells should be aligned bottom left
  • Table Row style for numerical cells
  • Table Text style for text cells

Source and notes

  • Like figures, all tables must have a source line
  • The notes line can include notes applying to the whole table, notes for a particular row or column (use superscripted letters), and notes on significance levels (use asterisks). More details:
  • Use asterisk to indicate statistical significance, use em dash to indicate missing values, and use caret symbol to indicate masked values.
  • Define all abbreviations or symbols in notes.
  • Use superscript letters to denote notes, even when only one note appears in a table. However, numerals may be used for tables whose data consist mainly of words or letters; and symbols may be used for tables that include mathematical or chemical equations, where superscript letters or numerals might be mistaken for exponents. When symbols are used, the sequence is as follows:
    1. * (asterisk; but do not use if p values occur in the table; see 3.81)
    2. † (dagger)
    3. ‡ (double dagger)
    4. § (section mark)
    5. || (parallels)
    6. # (number sign, or pound)
  • Figure/Table Notes style

Styles section of Home tab in Microsoft Word

PC

Screenshot of the style section of the home tab in Microsoft Word on a PC.

Mac

Screenshot of the style section of the home tab in Microsoft Word on a Mac.

Tables for the Web

Tables for the Urban website—including the Urban Wire and Data at Urban blogs—should follow the formatting shown in the images below. Many figures and tables for the Urban Wire blog are built in the Datawrapper tool; contact the data visualization or blog team for assistance.

Detailed diagram of the layout, font, font size, and color of the elements in an Urban Institute table. Detailed table showing the font, size, color, and alignment of all text types in an Urban Institute table.

There are many ways to make your tables more visual by adding icons, color shades, small charts, and more. For additional options, see Ten Guidelines for Better Tables.

Table showing the distribution of federal tax by cash income percentile in 2010 for six different metrics. Each column includes the number and a small bar chart.