Customizing your choropleth map

After importing the data for your choropleth map, you can now refine, annotate, and design it in step 3: Visualize. In this tutorial, we'll walk you through the different options. 

In the Refine tab, you can find three panels: Colors, Legend and Appearance. 

Refine: Colors

With the Color panel, you can decide which colors the regions should have on your map. If you imported multiple columns, you can choose which ones you want to visualize on your map at the top.

If you imported  numerical values (e.g. percentages or population numbers), you'll see these options: 

Datawrapper automatically maps your values between the lowest and the highest number in a linear interpolation. You can choose another color gradient with a click on the gradient at the top. 

👉 To learn which interpolations to use, visit our Academy article   "How to choose stops for choropleth maps".
👉 To learn how to work with these color options, visit our Academy article "How to use the color palette tool"

For our map, we choose another gradient and set the interpolation from linear to natural: 

If you want to visualize  categorial values (e.g. "yes"/'no" or "Republican"/"Democrat"/"Independent"), you'll see all your categories. Click on them and then on the color swatch to change their colors: 

Now that you chose your colors, let's make sure readers can make sense out of them with your legend:

Refine: Legend

By default, Datawrapper shows a legend. You can customize it in the second panel, "Legend": 

Here you can give your legend a title and decide how it should be displayed. Click on "more options" to not miss all the positioning options! 

We changed the number format to 0% because we want to show a percentage ( unemployment rate). 

👉 To learn which legend types exist and how to use them, visit our Academy article   "How to customize your map legend".

Refine: Appearance

The third and last panel in the Refine tab is the Appearance panel. Here you have five options:

  • Make map zoomable makes...well, the map zoomable. You will see that this succeeded if your map gets a grey minus & plus button at its bottom-right corner.
  • Hide regions without data: regions without data will not be shown on the map. 
  • Map alignment: determines the positon of the map on the background. Often, a map fills the background completely, like an US map. If you work with such a map and the map padding is set to zero, this option won't have any effect.
  • Map padding: adds padding around the map. If your map legend covers parts of the map, use Map padding and Map alignment to move the map next to the legend. 
  • Max. height (px) - Datawrapper by default will automatically adjust the height according to its width to reduce any unnecessary white space around the map. But when you have a long map like Chile, for example, you might want to set a maximum height to avoid all the scrolling: 

These are all the settings you can find in the Refine tab. Let's move on to the Annotate tab:

Annotate: Annotate your chart

If you've created a Datawrapper chart or map before, you already know this feature. Here you can give your map a title, a description, add notes and a source:

  • We recommend writing in the title what's interesting about the map – the one key statement that you want to show on this map, if you have one. E.g. "Unemployment highest in the south"
  • The description should have as much information about the data as possible: What do we see exactly? E.g. "Unemployment rates in % in all US states, 2016"
  • Think of notes as footnotes, where you want to specify any abnormalities about your data. E.g. "California unemployment rates from Jan and Feb 2016 not included in the calculation."
  • The source name will give your readers the information on how trustworthy your data is. Does it come from a government institution or another trustworthy organization? The source URL lets your reader dig even deeper and have a look at the underlying data themselves. Both, source name and source URL, should be filled out on every map to increase transparency. E.g. US Bureau of Labour Statistics, August 2017
  • Last but not least, add your name and/or organization as the byline.

Annotate: Map labels

As soon as you select a column for your map labels, they'll show up on your map – if you see the min. zoom for labels to 1 and are in a zoomed-out view:

Our map is too detailed for this feature, so turning in on isn't a good idea for zoom level 1. However, map labels that readers will see even if not zoomed in make a lot of sense in maps with bigger regions (e.g. US states, European countries).

The solution for our map is too set the min. zoom for labels higher. Play around with the slider while zooming in to see which zoom level makes the most sense.

To still show the most important county names even before readers zoom to the min. zoom for labels, you can use the Highlight regions option. Use the dropdown menu to select the regions you want to see labeled: 

👉 To learn how to display not just the value or the region name but both on your maps, visit our article "How to display both label and value on choropleth maps"

Annotate: Tooltips

By default, Datawrapper displays your region names and values as the tooltips. In the last panel in the Annotate tab, you can first decide if you want to display tooltips at all or not. 

Since maps rely only on color and are therefore hard to read, tooltips can be a great help for readers to make sense out of the data. For our map, we're turning them on. 

A click on Customize Tooltips will open two text fields. Below the text fields, you can find all the columns you imported as blue buttons. Click on them to integrate them in your tooltips:

👉  To learn more in-depth how to create tooltips, visit our article  "How to create tooltips".
👉  To learn how to customize tooltips – e.g. with bold text, If/Else statements or tables – visit our article  "How to customize tooltips"

After we worked through the Annotate options, there's only one tab left: Design.


In this last tab, you can decide in which  layout your chart should be published. Should it come in the Datawrapper design? Or (if you or your organization decided to style a chart) in the design of your organization? 

You can also change the  Output Locale for your map. This affects the language of the attribution in the bottom left of your map and defines decimal and thousand separators as well as translation of month and weekday names.

You can also enable Social Sharing here. If you do that, the share buttons for Facebook, LinkedIn and Twitter will appear on the top-right corner of your map. 


Once we have worked through Refine, Annotate and Design in step 3:  Visualize, we can now proceed to step 4: Publish & Embed.  The best way to use a Datawrapper chart is by embedding it directly on your website. To do that, click the big blue button that says " Publish chart". Then, copy & paste the embed code snippet into your website or CMS. 

You can also  download your chart in two formats. First, users of all subscription plans have the option to download their chart as a PNG. Custom and Enterprise plan users also have the option to download their chart as a PDF or SVG. Click here for more information on the different pricing plans of Datawrapper.

In this tutorial, we gave a quick overview of all the options that you have to customize your Choropleth map. You can find more detailed explanations about the color palette, tooltips and custom map keys in other articles.