Language
English

Embedding maps

Once you publish a map, it's available as a view-only embedded viewer you can drop into your own website, app, or portal.

This page covers embedding a published map for viewers who have no Fabric access - a public site, a customer portal. If instead you're embedding into your own internal application, where every viewer signs in with their own work account and should see only their own data, see Embedding for your organization. That mode is live rather than published, and applies your Fabric row-level security per viewer.

How it works

A published map is served from a URL such as https://embed.iconmap.ai/v/pub_XXXX. You place that URL in an <iframe> on your page, and the map appears inline — fully interactive for panning and zooming, plus any controls you enabled (navigation, scale, projection, basemap switcher, layer toggle), but view-only: viewers can't change the map or reach the authoring experience.

Data and access

  • The embedded map reads only the frozen published files from your OneLake; the underlying Fabric data and item are never exposed.
  • Access is governed by the publish settings — anonymous link, signed tokens, and an allowed-origins allow-list.
  • A dedicated reader identity is used to serve the published files; your administrator sets this up once (see Security & permissions).
  • Because the embedded map reads only those published files, images on 3D models that come from OneLake paths in your data are not shown. Use web URLs or SVG in the data instead; see Text and images on 3D models.

Controlling the map from your page

The page that hosts the map can drive it from JavaScript - move the camera, show and hide layers, apply filters and slicers, select features, save and restore views - and hear back what the reader does, much as the Power BI Embedded client library does for reports. The map's author decides which sites may do this, and which kinds of command they may use, in the Publish dialog.

Developers: see the Embed API. Pages that cannot run script can still open a map in a chosen state with a deep link.

Reading-view controls

You decide which controls the embedded viewer offers, so you can present anything from a locked-down static-looking map to a fully explorable one with basemap switching and layer toggles.

Next steps