Map
Geo · Values by country
Added from the Insert tab; configure it in the card’s Data and Format tabs.
When to use it
Section titled “When to use it”A choropleth — regions shaded by value. DataSquares picks world-countries or US-states automatically from your location data, or you can pin the level in Format → Map. Geography as the primary lens: where, not just how much.
Field wells
Section titled “Field wells”| Well | Accepts | Notes |
|---|---|---|
| Location | dimension | country names/codes, or US states — for a region (choropleth) map |
| Latitude | dimension | for a point map; both coordinates are required together |
| Longitude | dimension | for a point map; both coordinates are required together |
| Value | measure | drives the fill color on a region map, the dot color on a point map |
| Size | measure | scales each dot on a point map; a region map ignores it |
| Tooltip | fields | extra columns listed under the region name on hover |
Measure wells carry a quick-calc dropdown (running total, YoY %, % of total, …); SquareX measures drop in like any field.
Format options that matter here
Section titled “Format options that matter here”- Location level — Auto-detect, World — countries, or US states
- Allow pan & zoom — off locks the viewport where you framed it
- Show color scale, with an optional min/max range (blank = derived from the data)
- Show unmatched-locations notice — the notice described below
The full panel is described in Charts & formatting.
- Names are matched loosely: case, accents, punctuation, hyphens and a leading “the” are all ignored, and the common aliases resolve —
USA,UK,Czech Republic,Viet Nam,Russian Federation,Korea, South,Türkiye. - One row can name several countries. A value like
United States, India(comma, semicolon or pipe) credits its full value to each country listed — it is not split between them. - US states resolve by name or postal code (
California,TX). The map switches to US states by itself when state data dominates; pin it with Location level if the guess is wrong. - Rows that match nothing are counted in a notice on the card — click it to see exactly which values didn’t bind, then fix them at the source or filter them out.
- If nothing matches at all (sales regions like “East”/“West”, say), the card tells you so instead of drawing an empty world.