Sharing & Embedding

Once you have a map you like, you can publish it as a public link and embed it in any web page. This tutorial covers both. See Embedding & Sharing for the full reference.

1. Set your share token

Sharing uploads to the configured MappView Share service using a personal API token.

1. Open Settings → Environment Variables.
2. Paste your token into the MappView API token field. Create one under Settings → API tokens in your MappView Share deployment.

You only need to do this once.

2. Share the project

1. Build your map: add layers, style them, and set the map view you want viewers to land on.
2. Open Project → Share….
3. Confirm the project title and upload. MappView returns a public URL to a .mappview.json file on your MappView Share deployment, for example:

   https://share.example.com/you/my-map.mappview.json

The shared file captures the same layers, styles, plugin state, and map view as a local save.

3. Open the shared map

Anyone can open the shared project in the live viewer by passing it as the url parameter:

https://viewer.example.com/?url=https://share.example.com/you/my-map.mappview.json

4. Embed it in a page

Use an <iframe> and the embed parameters to control the chrome. For a clean, map-only embed:

<iframe
  src="https://viewer.example.com/?url=https://share.example.com/you/my-map.mappview.json&amp;maponly"
  title="MappView map"
  width="100%"
  height="600"
  style="border: 0;"
  loading="lazy"
  allow="fullscreen; geolocation"
></iframe>

Adjust the look with parameters (they combine):

• maponly hides all chrome, leaving only the map.
• layout=compact keeps a slim, icon-only toolbar.
• panels=none hides the side and bottom panels but keeps the toolbar.
• theme=dark forces the dark theme on load.

See the full parameter table.

Next steps

• Tune which controls appear before sharing with the Controls menu.
• Revisit Your First Map to build the map you want to share.