Loading

Best Practices for creating Marker Layers in Salesforce Maps

Publiceringsdatum: May 11, 2026
Beskrivning

When creating marker layers there are numerous considerations to achieve the most optimal performance and results when plotting on the Map. This document provides best practices and considerations when creating the Marker Layers in SF Maps. This will include performance impacts, technical structure, and limitations. 

Please note this article is written based on generic performance but performance can vary based on the network connection, browser, device, interaction with shape layers, updating records via Maps Actions, and individual Salesforce org performance.

Lösning

Preparing Data:

For new customers or for the implementation of a new base object, consider batch automation for geocoding records prior to rolling out to the end users. This will help minimize the time it takes for a marker layer to plot and bypass potential permission-related issues for the end user when writing the latitude and longitude coordinates back to the record.


Creating Marker Layers:

When creating a Maps Marker Layer you are utilizing the Marker Layer Builder to create SOQL queries to execute via Remote Apex. For optimal performance, we recommend reviewing best practices with SOQL especially when working with large data volumes and not filtering by null values and using selective filters. Additionally, we offer additional filter types that can be run as a subquery which can impact the records returned. Please review Use Filters to Build a Marker Layer in Salesforce Maps for more information. Our default permission group is set to a limit of 5,000 records per marker layer and can be extended in the permission group settings but the number of records returned and how they are displayed can have an additional impact on performance.


Displaying Marker Layers and considerations for additional options:

Although both the number of records that are being queried and the number returned can impact performance, how they are displayed adds another layer of complexity to how the layer performs. We offer various ways to style your maker layers out of the box as well as provide the ability to upload your own custom icons. Here are some considerations for some of the ways to style your markers after the SOQL query executes:
 

  • Uniform- Optimal performance as only one color and shape are displayed
  • Varied Based On 1 Field or 2 Fields- Consider the type of field(s) chosen and the number of values tied to those fields. For example, a picklist that has 40 different values will take longer to color code so the greater the number of unique records returned, the longer the processing time to display each value on the map.
  • Labeled Pins- Requires an additional call out to a vendor to display the chosen field and the length of the text to display can increase processing time
  • Proximity- will calculate the distance defined for each marker, which can increase load times depending on distance, number of records returned, and display options of the marker.
  • Map Updates- When refreshing the layer while using large data sets or complex display options, consider the frequency of the refresh, providing ample time to execute the query as well as display on the map.

Updating Salesforce Records From Marker Layers:

Salesforce Maps allows mass actions from the marker legend as well as updating colors and shapes on the map. Please consider the number of records being updated and any automation on the object that might be triggered from a field update or ownership change made from Salesforce Maps.

See Also:

Knowledge-artikelnummer

000395535

 
Laddar
Salesforce Help | Article