Skip to main content

How do I configure a geo map widget?

Overview

A geo map widget plots your data on a map, so you can see how a metric varies by location at a glance.

When to Use

Use this feature when:

  • You want to see how a metric breaks down by geography — region, state, country, or a similar location field
  • You want a visual, at-a-glance view of location-based patterns rather than a table of location values

Concepts

  • Geo Map – A widget type that plots your data on a map, with values shown by location
  • Location Field – The field in your data that identifies each map point or region, such as a region, state, or country column
  • Metric – The value shown at each location, with an aggregation such as Sum, Count, or Average 
  • Basemap – The underlying map tiles the widget draws on top of, sourced from CARTO

Set Up Guide

  1. Go to a dashboard and click Add Widget, then set the Title, Apply Dashboard Filters, Widget Type (Geo Map), and Data Source as usual
  2. Choose the Location field [TODO: confirm exact field label and whether it must be a specific geography type]
  3. Choose the Metric field and aggregation [TODO: confirm exact field label]
  4. Apply any filters you want the map to respect
  5. Click Save & Apply

Best Practices

The map's basemap tiles come from CARTO, which began watermarking tile requests in September 2026 — a watermark on the map is expected, not a sign something is broken [TODO: confirm whether Learners actually see this watermark on the live dashboard]

[TODO: add a tip once Location/Metric field behavior is confirmed — e.g. what happens when a location value can't be matched to a place on the map]

  • What widget types are available in Vantage?
  • How do I configure a chart widget?
  • How do I configure a summary table or pivot table widget?
FAQs

What location data does a geo map w idget need? [TODO: confirm exact requirements — region/state/country names, postal codes, or coordinates]

Why does the map show a watermark?
The map's basemap tiles come from CARTO, which began watermarking tile requests in September 2026. This is expected and not an error with your dashboard.

Version Notes

Last Updated: 22 Oct 2026

Back to top