Embed reference

Embed a KnowMapped map on your website.

Use an iframe for a copy-and-paste embed. Use the Web Component when the page needs control over the title, dimensions, frame, background, or visitor interaction. Both render the same public map.

Live embed

This example loads a published map through its public-view URL.

Embed with an iframe

The iframe loads the public map viewer in a separate browsing context, which avoids conflicts with the host page’s styles and scripts. Set its dimensions in the surrounding page layout.

01

The markup

Replace 27aca0fe-ea08-4a15-97ee-b0ade9ae4dff with the ID of any public map.

<iframe
  src="https://knowmapped.com/view/27aca0fe-ea08-4a15-97ee-b0ade9ae4dff?embed=1"
  width="100%"
  height="650"
  style="border:0"
  loading="lazy"
  allowfullscreen>
</iframe>
02

Adjust settings

When copied from KnowMapped, the embed URL includes the public-view settings you selected.

Editing a map does not update its public version. Publish the new snapshot in KnowMapped; the iframe URL stays the same.

The Web Component

The Web Component renders the same viewer without an iframe. Its attributes control the title, dimensions, frame, background, and exploration behavior. Include the script once on each page that uses the component.

<script type="module" src="https://knowmapped.com/embed/v1/knowmapped-embed.js"></script>

<knowmapped-map
  map-id="27aca0fe-ea08-4a15-97ee-b0ade9ae4dff"
  show-title
  height="650px"
  data-width="normal"
  data-show-frame="true"
  data-show-background="true"
  data-exploration="true">
</knowmapped-map>

Boolean options default to on. Set an option to false to turn it off, for example show-title="false".

AttributeRequiredDescription
map-idYesUUID of the public KnowMapped map to display.
show-titleNoDisplays the map title above the visualization. Defaults to shown.
heightNoSets any valid CSS height, such as 650px, 70vh, or clamp(400px, 60vw, 800px). Without it, the map chooses a responsive height automatically.
data-widthNoControls the layout width. Accepts normal (default), wide, or full.
data-show-frameNoShows the border, rounded corners, and shadow. Set to false for a frameless map. Defaults to true.
data-show-backgroundNoShows the map theme background and grid. Set to false for a transparent background. Defaults to true.
data-explorationNoAllows visitors to pan, zoom, and inspect map content. On touch devices, visitors choose Explore map before interacting. Set to false for a fixed presentation. Defaults to true.

How embeds behave

Embeds display public maps and do not grant editing access. A private map remains unavailable to the embed. Publish it inKnowMapped before adding it to a page.

Interaction

Visitors can pan and zoom, inspect knowledge-map relationships, and follow futures-wheel consequence branches.

Layout

The viewer fills its container. Set the height on the iframe or Web Component to fit the page layout.

Framework-neutral

The Web Component works in plain HTML and framework-based sites, including Astro, WordPress, and React.

Public maps only

The embed serves maps published as public. Private maps are not available through the embed code.