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

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