AX - Map
Overview
AX - Map is a Lightning App Builder component that shows records from any Salesforce object as markers on a map, on record, app and home pages. Markers come from address fields or latitude and longitude. End users click a marker for its details, and search and filter the locations.

Getting Started
Learn the basics in this tutorial.
Key features
Customization: dynamic titles and marker descriptions, styled headers.
Metrics: SUM, COUNT or AVG in Metric Aggregation Fields, shown above the map.
Dynamic Bindings:
{{Record.FieldApiName}}for context-aware displays.Visual Options: card display, toggles to restrict the map controls.
Use Cases
Account Page: related Contacts, offices, site visits.
Opportunity Page: store or partner locations.
Custom Object Page: service locations, assets, delivery points, project sites.
Sales Territory Dashboard: active Accounts or Leads by region.
Service Operations: technician job sites, case locations.
Event Planning: venues, marketing zones.
Configuration
The properties panel is one flat list.


Header - Show Number of Records adds the count after the title, with a plus sign when more records match than the map shows.


Properties
Object API Name
String
—
API name of the Salesforce object used to retrieve records displayed as map markers. Examples: Account, Lead, Custom_Object__c.
Filter
String
—
SOQL WHERE clause used to filter which records are shown on the map. Example: Status = 'Active' or Region__c = 'West'.
Order By
String
—
Comma-separated field API names used to sort the records before display, each optionally followed by ASC or DESC and NULLS FIRST or NULLS LAST; ascending by default. Example: Name or LastModifiedDate.
Maximum Number of Records
Integer
—
The maximum number of records to retrieve and display as markers on the map. Helps manage performance and avoid clutter.
Title Field Name
String
—
Field API name used as the title for each marker. Examples: Name, Subject, or Title__c.
Description Field Name
String
—
Field API name used as the description for each marker. Examples: Description, Summary__c, Details__c.
Street Field Name
String
—
Field API name for the street address of a record. Example: BillingStreet, ShippingStreet.
City Field Name
String
—
Field API name for the city portion of the address. Example: BillingCity, ShippingCity.
Postal Code Field Name
String
—
Field API name for the postal or ZIP code. Example: BillingPostalCode, MailingPostalCode.
State Field Name
String
—
Field API name for the state or province. Example: BillingState, ShippingState.
Country Field Name
String
—
Field API name for the country. Example: BillingCountry, ShippingCountry.
Latitude Field Name
String
—
Field API name for the latitude coordinate (used when address fields are not provided). Example: Latitude__c.
Longitude Field Name
String
—
Field API name for the longitude coordinate (used when address fields are not provided). Example: Longitude__c.
Filter Fields
String
—
Comma-separated list of field API names displayed in the filter panel for user-driven filtering. Examples: Region__c,OwnerId,Type.
Metric Aggregation Fields
String
—
Comma-separated list of aggregation expressions in the form Function(FieldApiName) — e.g. SUM(Amount), COUNT(Id), AVG(Score__c) — computed across the displayed records and shown as summary metrics.
Show Search
Boolean
false
If true, displays a search bar above the map for keyword search on supported fields.
Disable Default UI
Boolean
false
If true, hides default map UI controls such as zoom buttons and street view toggle.
Disable Double Click Zoom
Boolean
false
If true, disables zooming via double-click.
Disable Dragging
Boolean
false
If true, disables the ability to move the map by dragging.
Disable Scrollwheel Zooming
Boolean
false
If true, disables zooming with the mouse scroll wheel.
Header - Title
String
—
Text displayed as the main title in the component header. Example: “Service Locations” or “Customer Map.”
Header - Caption
String
—
Subheading text displayed below the header title to provide context. Example: “Showing active accounts” or “Filtered by Territory.”
Header - Icon Name
String
—
SLDS icon name (e.g., standard:address) displayed beside the header title. Example: utility:map for geographic views.
Header - Show Number of Records
Boolean
false
If true, displays the total number of items in the map at the top of the component.
Action - Show More Details Panel
Boolean
false
If true, enables a side panel that displays additional record details when a row is selected, providing deeper context without leaving the page.
Action - Full Screen
Boolean
false
If true, displays a button that allows users to expand the map to full screen, improving visibility for large datasets or detailed analysis.
Action - Enable Record Create
Boolean
false
If true, displays a button that allows users to create a new record in the map.
Display as Card
Boolean
true
If true, displays the map inside a styled card container for better visual presentation in dashboards or record pages.
Use Case Examples
Each example adds AX - Map as above, then sets:
On the Account record page: each contact at its mailing address, filtered by role, for territory management.
Object API Name
Contact
Filter
AccountId = {{Record.Id}} (the current account's contacts)
Title Field Name
Name
Description Field Name
Title
Street Field Name
MailingStreet
City Field Name
MailingCity
Postal Code Field Name
MailingPostalCode
Country Field Name
MailingCountry
Show Search
Checked
Filter Fields
Title
Header - Title
Contacts for {{Record.Name}}
Header - Icon Name
standard:contact
Disable Dragging
Checked (no accidental moves)

On the Account record page: all accounts at a glance, for the sales team.
Object API Name
Account
Title Field Name
Name
Description Field Name
Industry
Street Field Name
BillingStreet
City Field Name
BillingCity
Postal Code Field Name
BillingPostalCode
Country Field Name
BillingCountry
Show Search
Checked
Filter Fields
Industry
Header - Title
Accounts Overview
Header - Caption
World map
Header - Icon Name
standard:account
Disable Dragging
Checked
Action - Show More Details Panel
Checked
Action - Enable Record Create
Checked

On a Service Dashboard page: active service locations by GPS coordinates, filtered by region.
Needs a custom Service_Location__c object with Status__c (Active/Inactive), Latitude__c and Longitude__c (numbers) and Region__c (picklist or text).
Object API Name
Service_Location__c (or your custom object)
Filter
Status__c = 'Active'
Title Field Name
Name
Latitude Field Name
Latitude__c
Longitude Field Name
Longitude__c
Display as Card
Checked
Disable Default UI
Cleared
Show Search
Checked
Filter Fields
Region__c

Key Considerations
Location Fields: address (geocoded) or latitude and longitude (more precise); map at least one set.
Dynamic Bindings:
{{Record.FieldApiName}}in filters and headers, on Record Pages.Performance: Maximum Number of Records goes up to 1000; lower it and test filters.
Map Controls: disable dragging and zooming for static views, keep them for dashboards.
Accessibility: clear titles and captions; test markers with a keyboard.
Troubleshooting Common Issues
No markers
Object API Name, Filter, location fields, permissions
Bindings fail
{{Record.FieldApiName}} context, in the record page preview
No search or filters
Show Search checked, Filter Fields set
Map not interactive
Disable Dragging and Disable Default UI cleared, permissions
Markers overlap
Lower Maximum Number of Records or add a Filter; clustering needs the Map in Dynamic Components
Layout issues
Display as Card, then test on mobile
Last updated
Was this helpful?

