19  Annotating and Formatting Visualization and Mapping Geographic Data

NoteWhat This Chapter Covers

Even the best chart fails to communicate if the reader cannot locate the key insight quickly. Annotations, text notes, marks, and highlighting, direct the reader’s attention to the finding that matters most. This chapter covers Tableau’s full annotation toolkit (mark annotations, point annotations, area annotations, and captions), the complete worksheet formatting hierarchy (from workbook-level defaults to individual mark formatting), and geographic visualisation in Tableau, building filled maps, symbol maps, and density maps, understanding how Tableau geocodes data, and handling mapping data quality issues. Together, these skills bridge the gap between a technically correct chart and an insight-ready presentation.

flowchart TD
    A[Completed <br> Visualization] --> B[Annotate <br> Key Findings]
    A --> C[Format <br> Layout & Text]
    A --> D[Map <br> Geographic Data]
    B --> B1[Mark Annotation <br> Point Annotation <br> Area Annotation]
    C --> C1[Worksheet Format <br> Font / Shading <br> Borders / Lines]
    D --> D1[Filled Map <br> Symbol Map <br> Density Map]
    D --> D2[Geocoding <br> Custom Geo]
    style A fill:#e3f2fd,stroke:#1976D2
    style B fill:#fff9c4,stroke:#F9A825
    style D fill:#e8f5e9,stroke:#388E3C


19.1 Annotations in Tableau

NoteThe Three Types of Annotations

Tableau provides three annotation types, each serving a different purpose:

Annotation Type What It Points To Best For
Mark annotation A specific data mark (bar, point, line mark) Calling out a specific data value, “This was our best quarter”
Point annotation A specific X/Y coordinate on the chart Marking a threshold or event date on a line chart
Area annotation A rectangular region of the view Highlighting a period or a cluster of marks

Adding an annotation: 1. Right-click directly on a mark, a specific coordinate, or select a region. 2. Select Annotate > Mark, Point, or Area. 3. In the annotation editor, type the annotation text. Use <field> tokens to insert live data values (e.g., “Peak: <SUM([Sales])>” displays the actual value). 4. Click OK. The annotation box appears with a leader line pointing to the annotated element. 5. Drag the annotation box to the optimal position, away from other marks, within the chart boundary.

[Insert screenshot of a line chart with a Point annotation on the highest data point, labelled “Q4 Peak: $287,432”, with a thin grey leader line connecting the annotation box to the mark]

NoteFormatting Annotation Boxes

Annotation boxes have independent formatting controls that are separate from the rest of the chart. To format an annotation:

  1. Right-click the annotation box and select Format Annotation.
  2. In the Format Annotation panel: set Font (size, weight, colour), Shading (background fill, use white with 80% opacity for readability over complex backgrounds), Border (thin grey border or no border), and Line (leader line style, colour, weight).

Annotation design principles: Keep annotation text short, no more than two lines. Use a font size slightly smaller than the chart title (14pt chart title → 11pt annotation). Position annotations outside the data area when possible. Use annotations sparingly, more than three annotations per chart creates visual competition that dilutes the impact of each one.

NoteCaptions and Titles

Captions appear below a worksheet and provide descriptive context that cannot fit in the chart itself. Enable via: Worksheet > Show Caption. Edit the caption with dynamic field references.

Worksheet titles: Every chart should have a declarative title, one that states the finding, not just the topic. Compare: “Sales by Quarter” (topic title, tells the reader what to look at) vs. “Q4 Revenue Rebounded 23% After Mid-Year Decline” (declarative title, tells the reader what to conclude). Go to Worksheet > Title to edit. Use <PageName> and <Sheet Name> dynamic variables to automatically include context.

[Insert screenshot showing a chart title edit dialog with a declarative title and the dynamic PageName variable inserted]


19.2 Worksheet Formatting Hierarchy

NoteUnderstanding the Formatting Cascade

Tableau applies formatting in a hierarchical cascade, from the most global to the most specific. A format set at a lower level overrides a format at a higher level:

  1. Workbook-level defaults (Format > Workbook), Sets default font, colour, and line style for all sheets in the workbook.
  2. Worksheet-level formatting (Format > Worksheet), Overrides workbook defaults for the current sheet only.
  3. Row/column-level formatting, Overrides worksheet defaults for a specific header row or column.
  4. Field-level formatting (right-click a field > Format), Overrides row/column formatting for a specific field’s numbers, dates, and text.
  5. Mark-level formatting (right-click a specific mark > Format), Overrides everything for a single data mark.

Understanding this hierarchy prevents the common frustration of formatting a chart repeatedly and having changes appear inconsistently. Always set the most general format at the workbook level (font family, base font size) and override at lower levels only when specific marks need emphasis.

NoteThe Format Pane: Detailed Controls

Open the Format pane via Format > Font (or any other format option). The Format pane appears on the left, replacing the Data pane. It has three sections:

Font section: Sets font family, size, weight, and colour for: the worksheet title, column/row headers, pane (cell) text, tooltip text, and axis labels. Each element is independently configurable.

Alignment section: Sets text alignment (left, centre, right), text direction (horizontal, up, down for rotated axis labels), and text wrapping for header cells.

Shading section: Sets background colours for: the header band, pane (the chart area), and row/column alternating banding. The chart pane background should almost always be white (#FFFFFF) or a very light grey, never a saturated colour that competes with the data.

Borders section: Sets the inner and outer cell borders, row/column dividers, and pane borders. For clean modern charts: remove all inner borders, keep a thin outer pane border (1pt, light grey).

[Insert screenshot of the Format pane open on the left side of Tableau Desktop, showing the Font section with individual controls for Title, Header, Pane, Tooltip, and Axis Label text]


19.3 Geographic Data and Tableau’s Geocoding Engine

NoteHow Tableau Geocodes Data

Tableau has a built-in geographic database that automatically recognises and geocodes geographic fields, assigning latitude and longitude coordinates to place names. When Tableau detects a field containing geographic values (country names, state names, city names, ZIP codes), it assigns that field a geographic role and places a globe icon next to it in the Data pane.

Built-in geographic roles Tableau recognises:

Geographic Role Examples Recognised
Country/Region “United States”, “USA”, “US”, “United Kingdom”
State/Province “California”, “CA”, “New York”
City “New York”, “Los Angeles”, “London”
ZIP Code/Postcode “10001”, “SW1A 1AA”
County US county names
NUTS code European NUTS-level regions
Airport IATA airport codes (e.g., “JFK”)
Congressional District US congressional district identifiers

Assigning a geographic role manually: If Tableau does not auto-detect a geographic field (e.g., a field named Location_Code), right-click the field in the Data pane > Geographic Role > select the appropriate role.

NoteBuilding Your First Map in Tableau

Tableau builds a map automatically when you double-click a geographic field in the Data pane, it generates Latitude and Longitude fields and places them on Rows and Columns.

Step-by-step map construction: 1. Double-click State in the Data pane. Tableau generates a symbol map with one dot per US state. 2. Drag Sales to the Size shelf, dots resize proportionally to sales volume (a proportional symbol map). 3. Drag Profit to the Colour shelf, colour the dots by profit using a diverging palette: orange-red for negative profit, blue for positive. 4. Drag State to the Label shelf, labels each state mark with its name. Set label to Selected to avoid clutter when all states are shown. 5. To switch to a filled map: click the mark type dropdown in the Marks card and change from Automatic to Map. Tableau fills each state polygon with the colour encoding.

[Insert screenshot of a US filled map with states coloured by profit margin using a diverging orange-blue palette, with a legend visible on the right]


19.4 Types of Maps in Tableau

NoteFilled Maps (Choropleth Maps)

A filled map (choropleth) colours geographic polygons by a measure value. Each region is filled with a colour that encodes its value, dark for high, light for low (or diverging for measures with a midpoint).

When to use filled maps: - Showing how a measure varies across political or administrative boundaries (states, countries, districts). - The geographic boundaries are meaningful to the audience (e.g., sales territories, legislative districts).

Limitation: Filled maps are dominated visually by large geographic areas, which may have small populations or transaction volumes. Alaska and Texas appear dominant on a US map even if they have small sales volumes. For population- or transaction-weighted data, a proportional symbol map is more honest.

Building a filled map: Mark type = Map (not Automatic). Drag State to the Detail shelf and a measure to Colour.

[Insert screenshot of a US choropleth map showing Sales by State, with a sequential blue colour scale and state boundaries visible]

NoteSymbol Maps (Proportional Circle Maps)

A symbol map places a geometric symbol (usually a circle) at each geographic location, sized and/or coloured by a measure. Symbol maps avoid the polygon-size distortion of filled maps, a small geographic area with high value still has a large symbol.

Building a symbol map: 1. Mark type = Circle (or Automatic). 2. Drag a geographic field to Detail. 3. Drag a measure to Size and another to Colour. 4. In the Marks card, click Size and reduce maximum size (prevents large circles from overlapping in dense areas). 5. Add 70% transparency to the Colour to allow overlapping circles to remain visible.

Best for: City-level data where many data points are geographically close together (e.g., customer locations across a metropolitan area).

NoteDensity Maps (Heat Maps)

A density map visualises the concentration of data points, where many marks overlap, the colour is more intense. Use density maps for large point datasets (thousands of individual transactions or customer locations) where individual symbol marks would create an unintelligible mass of overlapping circles.

Building a density map: 1. Mark type = Density. 2. Drag a location field (City or Latitude/Longitude) to the Detail shelf. 3. Optionally drag a measure to Colour Intensity (the density colour represents both concentration and value). 4. Adjust the Intensity and Opacity sliders in the Marks card to balance cluster visibility with background map readability.

[Insert screenshot of a US density map showing order concentration, with high-density areas (coastal cities) appearing in dark orange-red and sparse inland areas appearing light]


19.5 Customising the Map Background

NoteMap Layers and Background Styles

Tableau’s map background (the base map beneath the data layer) has several style options that affect chart readability:

Map background styles (Map > Map Layers): - Normal, Full road and label detail. Best for city-level analysis where roads provide orientation context. - Light, Reduced label density, lighter colours. Best for most business analytics, clean and unobtrusive. - Dark, White labels on dark background. Best for dashboards with a dark theme. - Streets, Full street-level detail. Best for store-level or address-level analysis. - Outdoors, Terrain and topographic detail. Best for logistics and natural resource analysis. - Satellite, Aerial imagery. Rarely appropriate for business analytics, image detail competes with data.

Washout: Increase the Map Washout slider (Map > Map Options) to fade the background map, making your data layer more prominent. A washout of 60–80% is usually optimal for business maps.

Disabling the background map: For country-level comparisons, a plain white background is often cleaner. Uncheck all Map Layers to remove the background map entirely, leaving only the geographic shapes.

NoteHandling Geocoding Issues: Unknown Locations

When Tableau cannot geocode a location value, it marks it as Unknown and excludes it from the map. Unknown marks appear as a clickable indicator at the bottom right of the map view.

Common causes of unknown geocoding: - Misspelled location names (e.g., “Calfornia” instead of “California”). - Ambiguous names that exist in multiple countries (e.g., “Springfield” without a country or state context). - Non-standard abbreviations (e.g., “Calif.”, Tableau may not recognise this). - Custom geographic territories not in Tableau’s built-in database.

Fixing unknown locations: 1. Click the Unknown indicator on the map. 2. In the Special Values dialog, click Edit Locations. 3. Tableau lists all unrecognised values. For each, either select the correct matching location from the dropdown, or manually enter latitude and longitude coordinates. 4. Alternatively: create a geographic role mapping file (a CSV or Excel file with your custom region names and their corresponding lat/long or standard geographic keys) and blend it with your data.

[Insert screenshot of the Edit Locations dialog showing several unmatched location values with dropdown selectors to match them to recognised Tableau geographic entries]


19.6 Summary

NoteKey Concepts at a Glance
Topic Key Technique Access Point
Mark annotation Labels a specific data mark with text/values Right-click mark > Annotate > Mark
Point annotation Labels an X/Y coordinate position Right-click chart area > Annotate > Point
Area annotation Highlights a rectangular region Right-click > Annotate > Area
Declarative titles Title states finding, not just topic Worksheet > Title
Format hierarchy Workbook → Sheet → Row/Col → Field → Mark Format menu
Geocoding Auto-recognises countries, states, cities, ZIP codes Data pane (globe icon)
Filled map Polygon colour encoding by measure Mark type: Map
Symbol map Proportional circles at geographic locations Mark type: Circle + Size shelf
Density map Concentration heat map for large point datasets Mark type: Density
Unknown locations Fix unrecognised place names Map > Unknown indicator > Edit Locations
Map background Light, Normal, Dark, Satellite styles Map > Map Layers
TipApplying This in Practice

The most powerful annotation in a business presentation is not “Here is the data”, it is “Here is what this data means for the decision you are about to make.” Before adding annotations to a chart, ask: “What would a senior manager need to understand in the first 10 seconds of looking at this?” Write one annotation that answers that question. Then stop. One well-placed annotation with a clear, finding-oriented message is more influential than five annotations that compete for attention. Restraint in annotation is a mark of an analyst who understands the audience’s cognitive load.