Publishing & embedding
A new map starts in test mode — visible only to you. Publishing activates the map by applying a slot to it and gives you an embed snippet you can drop into any website.
Test mode
Every map you create begins in test mode. Only you can view it, and an embed of an unpublished map returns Not active instead of rendering. A test map stays active for 7 days, and its status badge reads test. To go live, activate the map with a slot.
Activating a map
Open the map’s Manage dialog and select the Publish tab. The Subscription option reflects one of three states:
| State | What you see | What to do |
|---|---|---|
| No slot available | ”No map slots available. Purchase a slot to activate this map.” | Buy a slot opens the subscribe dialog. |
| Slot available | ”You have available slots. Apply one to activate this map.” | Apply Basic or Apply Pro activates the map on that slot. |
| Active | ”This map is active. Free up the slot by removing it.” | Remove slot returns the map to test mode and frees the slot for another map. |
If you don’t have a slot yet, see Subscriptions & slots for how to get one.
Getting the embed code
The Embed code box on the Publish tab holds a ready-to-paste snippet. Copy it and paste it into your website’s source code, or into a custom HTML/Script block in your content management system:
<mapplic-map data-json="https://mapplic.com/getMapData?id=YOUR_MAP_ID"><script type="text/javascript" id="mapplic-script" src="https://mapplic.com/mapplic.js"></script></mapplic-map>The snippet is a <mapplic-map> custom element that loads the map’s data, plus a
script tag that loads the Mapplic library. You don’t need to edit it — the box
always reflects the correct map ID.
What Basic and Professional maps serve
The plan on a map’s slot affects what the embed serves:
- Basic maps render fully, but wayfinding routes are not served.
- Professional maps serve everything, including wayfinding and analytics.
Pinning a library version
By default the embed loads the latest Mapplic library (/mapplic.js), so your
published map automatically picks up updates and fixes.
A map can also be pinned to a specific library version. When it is, the embed script points at a versioned path instead, keeping the map on that exact version:
<script type="text/javascript" id="mapplic-script" src="https://mapplic.com/v/8.8.1/mapplic.js"></script>Previewing your map
The View button on the Publish tab opens the live map in a new tab, so you can check how it looks before sharing the embed.