Hi everyone,
We have a requirement to display the native Salesforce Maps managed-package UI inside an Experience Cloud LWR site, specifically within an OmniScript.
We have confirmed that Salesforce Maps itself is working correctly in our org. The managed-package Visualforce page:
/apex/maps__Maps
successfully loads the full Salesforce Maps UI for internal Salesforce users, including Layers, Routes, Schedule, List, and configured Maps layers.
We also found Salesforce's official documentation stating that
Experience Cloud site users can access Salesforce Maps, including guidance around Maps permission sets, permission groups, sharing settings, and Maps Community user licenses.
However, our site is an
LWR Experience Cloud site, and we haven't found official documentation that specifically confirms whether the native Salesforce Maps UI can be rendered inside an LWR site.
We have tried the following approaches:
- Native Salesforce Maps Aura component — not available because our site is LWR.
- Visualforce Page component in Experience Builder — not available in our LWR site's component palette.
- maps:MiniMapLightningComponent through maps:MapsLightningOutApp — fails from the portal context during the Lightning Out authentication/bootstrap process.
- Salesforce Maps managed VF page through /vforcesite/maps__Maps — the page loads but internally attempts to load maps__MapsLightningOutApp, which results in a 404 in the Experience Cloud domain.
- Direct /apex/maps__Maps URL — works for an internal Salesforce user, but an Experience Cloud portal user is redirected to the Salesforce login page because the portal session does not carry over to the Salesforce domain.
Our Experience Cloud users also have the appropriate Salesforce Maps access/permissions configured.
My question is:
Does Salesforce currently officially support rendering the native Salesforce Maps UI inside an Experience Cloud LWR site?
If yes:
- What is the officially supported implementation approach?
- Is there an LWR-compatible Salesforce Maps LWC or component?
- Is Lightning Out 2.0 supported for Salesforce Maps in an LWR Experience Cloud site?
- Is there a supported way to embed the maps__Maps Visualforce page for an authenticated Experience Cloud LWR user?
- Are there any additional configuration requirements for the Salesforce Maps domain/session to work with LWR?
If LWR is
not currently supported, is Salesforce Maps LWR compatibility on the roadmap, or is an Aura-based Experience Cloud site currently requiredfor the native Salesforce Maps experience?
#LWR
Hi Prajwal - short answer: the native Salesforce Maps managed-package UI is not supported as a component inside an LWR site, and it is an architecture limit rather than a Maps-specific one. LWR runs Lightning Web Components ONLY - it cannot run Aura components or Visualforce pages (that is the big difference from Aura-based Experience Cloud templates, which run both). The full Maps UI (Layers/Routes/Schedule/List) is delivered through that Visualforce/Aura managed-package page, so it has nothing to render as a native LWR component.
The docs you found ('Experience Cloud users can access Salesforce Maps') are about licensing, permission sets, and Aura-based site access - not LWR component support. So there is no official 'drop Maps into an LWR page/OmniScript' path.
Realistic options:
1. iframe the Visualforce Maps page inside a custom LWC that you place on the LWR page/OmniScript. Caveats: add the VF domain to CSP Trusted Sites, and mind the session - it works for authenticated site users who have the Maps licenses/permission sets, but guest-user access to the VF page is the usual sticking point.
2. Build a custom LWC using the Maps data (query the geolocation/records and plot them with lightning-map or a JS mapping library). More effort, but fully LWR-native and OmniScript-friendly.
If you truly need the full native Maps UI (not just a map), the iframe route is the only realistic one in LWR - just validate it against your guest-vs-authenticated user model early.
If this helps, please mark it as the Best Answer so it helps the next person - thanks :)