Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

AX - Map on a Lightning page in the Avonni app. The header shows a green map icon, the caption Accounts plotted from their billing address and the title Customer locations. Eight red markers sit on a Google map of the United States, from the Pacific Northwest and Los Angeles to Chicago and Boston, with zoom buttons at the bottom right.
Each record becomes a marker, under a header with an icon, a caption and a title.

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.

Component Comparison

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

1

Edit a record, app or home page, for example the Account record page.

2

Drag AX - Map onto the Page

Find it under Custom - Managed, select it, and set at least Object API Name and the location fields.

Lightning App Builder editing an Account record page named Account Page with Map. The Components palette is searched for AX - Map, listed under Custom - Managed. On the canvas the AX - Map component is selected: a card titled Accounts Overview (50) with the caption Great Lakes manufacturing, a search box, a Billing State/Province filter menu, three header buttons and a Google map with one marker. The Properties panel on the right shows Object API Name Account, the Filter, Order By Name, Maximum Number of Records 50, Title Field Name Name, Description Field Name Industry, and the Street and City field names.
AX - Map selected on a record page in Lightning App Builder, its properties on the right. In the editor the map draws sample data, not your records.
3

Save & Review

Click Save (and Activation for a new page), then open the page.

The properties panel is one flat list.

First half of the AX - Map Properties panel: Object API Name Account; Filter BillingState IN ('WI','IN','MI') AND Industry = 'Manufacturing', cut off by the box; Order By Name; Maximum Number of Records 50; Title Field Name Name; Description Field Name Industry; Street, City, Postal Code, State and Country Field Name set to the Billing address fields; Latitude and Longitude Field Name empty.
Data source and field mappings: which records to load, and which fields give each marker its title, description and location.
Second half of the AX - Map Properties panel: Filter Fields BillingState, Metric Aggregation Fields empty, Show Search checked, Disable Default UI, Disable Double Click Zoom, Disable Dragging and Disable Scrollwheel Zooming cleared, Header - Title Accounts Overview, Header - Caption Great Lakes manufacturing, Header - Icon Name standard:account, then Header - Show Number of Records, Action - Show More Details Panel, Action - Full Screen, Action - Enable Record Create and Display as Card checked.
Search and filters, map controls, header and actions.

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

A Google map of North America with eight red markers across the United States. The header shows an account icon, the caption Showing active accounts, the title Customer Map (8), a search box, a more details button at the top right and an Industry filter button. The Industry filter is open on Equals, with its own search box, the values Empty, Agriculture, Apparel, Banking, Biotechnology, Chemicals, Communications and Construction, a Clear link and the count 33 of 33.
The header settings at work: the icon, the caption and the title, the record count after the title, the search box, the more details button, and the Industry filter open.
AX - Map on an Account record page. The header reads Accounts Overview (11) under the caption Great Lakes manufacturing, with a search box, a Billing State/Province filter menu, and the details, full screen and New buttons. Eleven markers sit around the Great Lakes. The Riverfront Assembly Group marker is selected and its info window reads Riverfront Assembly Group, Manufacturing. The Details panel beside the map lists that account's fields: Account Owner, Phone, Account Name, Fax, Parent Account and Website.
With Action - Show More Details Panel checked, a header button opens a Details panel beside the map, and clicking a marker shows that record's fields in it.

Properties

Label
Type
Default
Required
Description

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.

Setting
Value

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)

A Google map titled Contacts for Atlas Logistics, with a contact icon, a search box and a Title filter button. Seven red markers sit in Minneapolis, Chicago, Los Angeles, Phoenix, Dallas, Charlotte and Miami. The Title filter is open and lists Account Executive, Operations Director and Regional Sales Manager, 3 of 3.
Result: the contacts of the account placed by mailing address, with search and the Title filter open on their three roles.

On the Account record page: all accounts at a glance, for the sales team.

Setting
Value

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

AX - Map on an Account record page. The header reads Accounts Overview (11) under the caption Great Lakes manufacturing, with a search box, a Billing State/Province filter menu, and the details, full screen and New buttons. Eleven markers sit around the Great Lakes. The Riverfront Assembly Group marker is selected and its info window reads Riverfront Assembly Group, Manufacturing. The Details panel beside the map lists that account's fields: Account Owner, Phone, Account Name, Fax, Parent Account and Website.
With Action - Show More Details Panel checked, a header button opens a Details panel beside the map, and clicking a marker shows that record's fields in it.

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).

Setting
Value

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

A Google map with a search box, a Region filter button and no title. Nine red markers sit at service locations across the United States, from Portland and San Diego in the west to Pittsburgh and Raleigh in the east. The Region filter is open and lists Central, East, South and West, 4 of 4. Map and Satellite buttons, zoom buttons and Street View stay visible.
Result: active service locations placed by latitude and longitude, with search and the Region filter open on the four regions.

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

Symptom
What to check

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?