Share your map

Publish and embed a map

Publish a reviewed version, choose public or protected access, and embed it on your website.

Understand public access

Version or link	Who can see it
Studio draft and Preview	Signed-in members of the active workspace, according to their role.
External viewer link	Anyone with the link in Public mode, when published and enabled. Protected mode disables anonymous viewer access.
Website embed	Public mode allows anonymous viewing. Protected mode requires your website’s authorized SDK integration and short-lived viewing tokens.

Protect a map and manage integration keys

As an owner or admin, open Share. Choose Protected under Access mode and save it before publishing sensitive maps.
Publish the reviewed version, enable website embeds, and save the exact allowed websites.
Open Developer access & API keys. Create a named server key with only the permissions your integration needs and choose its expiry.
Save the secret securely when it is displayed. It is shown only once. Give it to your backend developer through your organisation’s secret-management process; never put it in website code.
Your developer uses the SDK map ID and the protected SDK integration to authorize visitors through your own backend.

For store-information integrations, approve each field for read or write. Private fields require deliberate selection. Updates stay in the saved draft until an owner or admin publishes. Export permission separately grants the entire published map, including its geometry and public content.

Try saving and publishing separately

Loading practice example…

Rename the shop in the example, then choose Save draft. The workspace version changes while the visitor version stays the same. Publish the saved changes to update the visitor version, or unpublish the example to see what is retained.

Publish a version

Review the map in Preview, including place cards, labels and every floor.
As a workspace owner or admin, open Share in the studio.
Choose and save the intended access mode. Choose Publish map for a saved draft, or Save and publish if you have unsaved changes. A failed save prevents publication.
Wait for confirmation. In Public mode, open the External viewer link. In Protected mode, check the authorized SDK integration.

In Public mode, the first publication enables the External viewer link. Protected mode keeps anonymous viewer access disabled. Website embeds start disabled in both modes. The published map contains the version you published; later draft edits and saves do not change it.

Status	Meaning
Draft	There is no active published version.
Published	The published version matches your current draft. Check the sharing switches to see whether the viewer link and website embed are enabled.
Unpublished changes	There is an active published version, but the draft has newer changes.

Embed a public map on your website

Publish the map, then open Share and select Enable website embeds.
Under Allowed websites, add each website address that will display the map, one per line. Use HTTPS and include only the scheme and host, plus a port if your site uses one.
Choose Save sharing settings, then copy the Embed code.
Paste the code into an HTML or embed block in your website builder. If someone else maintains your website, give them the code.
Open the actual website page and check the map on desktop and mobile. Some website builders display previews on a separate domain, which also needs to be allowed if you want the map there.

Example allowed websites — list each version your site uses

https://harbour.example
https://www.harbour.example

Do not include a page path such as /visit, a wildcard such as *.example, or query parameters. You can list up to 20 exact website origins. Adding www does not automatically allow the address without www.

Example HTML — replace the src value with the embed URL copied from Share

<iframe
  src="YOUR_EMBED_URL_FROM_SHARE"
  title="Harbour Centre map"
  width="100%"
  height="680"
  style="border:0"
  loading="lazy"
  allow="fullscreen; geolocation"
  referrerpolicy="no-referrer"
></iframe>

Use the complete code copied from Share for your real map. The width follows its container; adjust height to suit your page. Keep a meaningful title so people using assistive technology can identify the map.

Update a live map

Make and preview your changes in the studio.
Open Share and choose Publish saved changes, or Save and publish if needed.
In Public mode, check the External viewer link after publication. In Protected mode, reconnect through your authorized SDK integration. The viewer link and embed URL stay the same, so your website code does not need replacing.

Republishing preserves your existing sharing settings. Share shows the latest ten publications and lets owners and admins restore an earlier version.

Restore an earlier published version

As an owner or admin, open Share → Publication history.
Choose Restore… beside the revision you want visitors to see.
Read the confirmation, then choose Confirm restore. In Public mode, check the External viewer link. In Protected mode, reconnect through your authorized SDK integration.

Turn off public access

In Public mode, the external viewer and website embed switches are independent. Turn off the route you no longer need and choose Save sharing settings. Turning off the external viewer does not turn off an enabled embed.

To stop both routes, choose Unpublish map in Share.
Read the confirmation and choose Confirm unpublish. Your editable draft is retained.
If you publish again later, the access mode is retained. The External viewer link is enabled again in Public mode; embeds start disabled in both modes. Review sharing settings before reusing the map.