Map
Display records with location data on an interactive map
The Map tool plots records
What is the Map Tool?
The Map tool displays records containing location data as pins on a world map. Nearby records are automatically clustered together, and you can zoom, pan, and click markers to explore your data geographically.
Prerequisites
To use the Map tool, your collection
If you don't see the Map icon in your toolbar, your collection may not have a Location field. Add one through Collection Configuration → Fields.
Using the Map
1. Open the Map
From your collection, click the globe icon in the toolbar to open the Map in the side pane.
2. View Your Data
Records with valid location data appear as markers on the map:
- Individual markers: Single records shown as pin icons
- Clusters: Groups of nearby records shown as circles with a count
3. Navigate the Map
- Zoom in/out: Use the zoom controls or scroll to adjust the view
- Pan: Click and drag to move around the map
- Globe view: The map displays as an interactive globe that you can rotate
4. Interact with Markers
- Hover over a marker to see a tooltip with the record's primary field and location
- Click a marker to select the record and view its full details
- Click clusters to zoom in and see individual markers
5. Switch Location Fields
If your collection has multiple Location fields, use the dropdown in the toolbar to switch between them. For example, you might have "Office Address" and "Home Address" fields.
Zoom Options
Use the zoom menu (magnifying glass icon) for quick navigation:
- Zoom in: Magnify the current view
- Zoom out: See a wider area
- Zoom to fit: Automatically adjust the view to show all mapped records
What Data Can Be Mapped?
The Map tool displays records from fields that contain geographic coordinates:
Location Fields
Standard Location fields that include:
- Address lines (line1, line2)
- City, county, country
- Postcode
- Latitude and longitude (required for mapping)
Lookup Fields
Lookup fields that reference Location fields in related collections.
Records without latitude and longitude values will not appear on the map. Ensure your location data includes coordinates for accurate mapping.
Example Uses
Enabling the Map Tool
If you don't see the Map icon in your toolbar:
- Open Collection Configuration (click ⋯ → Configure)
- Navigate to Features → Data Visualisation Tools
- Toggle on Map
The Map tool is only available for collections with at least one Location field containing coordinate data.
Tips
- Filters apply: The Map respects your current view filters, so you can map subsets of your data
- Clustering: Markers automatically cluster when zoomed out, making it easier to see distribution patterns
- Missing coordinates: If records don't appear on the map, check that their Location fields have latitude and longitude values
- Multiple locations: Use the field selector to switch between different Location fields in the same collection
Read our guide on Data Visualisation Tools to learn about other ways to explore your collection data.