Skip to content
Wander Developers

SDK changelog

wander-embed.js is a prototype and its API may change before v1. Every release is kept at a versioned URL so a production site can pin one build and upgrade on its own schedule. See Pinning a version for how to use these.

The machine-readable list is at https://developer.wandermaps.com/sdk/versions.json.

0.12.0 — 2026-10-23

Section titled “0.12.0 — 2026-10-23”

https://developer.wandermaps.com/sdk/wander-embed-0.12.0.js sha384-1Z0VZGoUsiTMHRki3N3ixMqqSPcmPxsMWezoMRXb3psO/w2LwP09u3Bl70GLdonO

  • Passes the host page’s non-empty utm_source, utm_medium, utm_campaign, utm_content, utm_term, fbclid, gclid, wbraid, gbraid, ttclid, msclkid and li_fat_id values into list, site and getting-here iframe URLs. Values longer than 200 characters are ignored; no other query fields or browser data are read.
  • Campaign passthrough is on by default. Set passCampaign: false in the embed options to opt out.
  • This release is opt-in by pinning the versioned URL above. The registry’s latest and the unversioned wander-embed.js remain at 0.11.0.

0.11.0 — 2026-10-23

Section titled “0.11.0 — 2026-10-23”

https://developer.wandermaps.com/sdk/wander-embed-0.11.0.js sha384-iRDbk8kR8xUGKppKBZNAOIlGe0dFxdvVm4CW24EqQMQ35qsxhj8ZOyC8FDr8KKZF

  • New boolean trailView option, default false. true adds trailView=1 to the site embed URL. Wander.map opts into the existing site-map API when this option is true; Wander.siteMap also accepts it. Wander.embedUrl follows the same choice.
  • New events: trailViewOpened, trailViewClosed, trailPlaceSelected, trailPlaceHovered and trailPlaceUnhovered. Payloads are relayed unchanged. sectionHighlighted and sectionSelected were already supported.
  • No new methods: use select, focus, clearSelection and highlightSection on the site map.
  • Without trailView, Wander.map keeps its list embed and byte-identical URL. Site-map URLs change only their sdk version parameter to 0.11.0.
  • wander-embed.js and the registry’s latest remained 0.8.0 at release. They have since moved to 0.11.0, so pages that load the unversioned wander-embed.js now get every 0.9.0–0.11.0 feature. Every release since 0.8.0 is additive, so 0.8.0 hosts keep working unchanged.

Site embed 2.2.0 — Trail View

Section titled “Site embed 2.2.0 — Trail View”

Opt in with trailView=1. The embed lists trailView in ready.capabilities, so hasCapability('trailView') (SDK 0.10.0 and later) detects it. Selecting a path POI draws the trail from start to end with start/end markers, mile ticks and association pins, and shrinks other places. A docked panel (when the visible map is at least 640 px wide) or a pull-up sheet (narrower) shows stats, the elevation profile, a mile-ordered timeline, sections and “Continues as” cards. Open it with select or focus, a visitor tap or a “Continues as” card. Marker POIs keep the normal place card. See Trail View and the SDK’s Trail listing pages example.

0.10.0 — 2026-10-10

Section titled “0.10.0 — 2026-10-10”

https://developer.wandermaps.com/sdk/wander-embed-0.10.0.js sha384-60kCl7EeS2FmqBQdS/KZGdq8gUObbt/1uZEhGOLto0A5e+7/o5b4XoQLZA7emRXw

Story-map features for the site map. They need site embed 2.1.0; see Story maps.

  • New line methods setLines(lines, options), clearLines(), animateLine(lineId, options) and setLineProgress(lineId, at). They draw a trail or creek from its path ID, or any line from coordinates, and draw it on over time or as the visitor scrolls.
  • New terrain methods setTerrain({ exaggeration, duration }) and resetTerrain({ duration }), which raise or lower the map’s relief at runtime.
  • New appearance methods setAppearance({ dim, color, duration }) and clearAppearance({ duration }). They dim the base map while your places, trails, areas and lines stay bright.
  • setContext items take accent: 'glow' and accentColor, and its options take reveal: { stagger }, for glowing pins and a staggered pin entrance.
  • New hasCapability(name) reads the features listed in the embed’s ready.capabilities.
  • New events: linesApplied, lineAnimationEnded, terrainChanged and appearanceChanged.
  • The new methods return a promise:
    • it resolves on the command’s completion event (setLineProgress: on its ack);
    • it rejects on an error for that command, or after timeoutMs (default 8000);
    • against an embed without the feature, such as 2.0.0, it rejects at once with code: 'capability_unavailable' and nothing is sent.
  • The SDK throws on a malformed argument, before sending anything.
  • A strict superset of 0.9.0: every 0.9.0 method keeps its signature and sends byte-identical messages. setContext sends reveal only when you pass it. Drop-in for 0.9.0 hosts.
  • wander-embed.js still serves 0.8.0.

0.9.0 — 2026-10-01

Section titled “0.9.0 — 2026-10-01”

https://developer.wandermaps.com/sdk/wander-embed-0.9.0.js sha384-E36Hg1m6sVHCow+VkPUBG1EtTloJ8oYDYQ34YQHhMYNdgBGZBoWfYNprFcYTUC8V

  • New section methods setSections(items, options), highlightSection(sectionId, options) and clearSections(), and events sectionsApplied, sectionHighlighted and sectionSelected. They show named stretches of a trail or creek, each with its own label and badge.
  • setSections checks that labels are at most 60 characters and colours use #RRGGBB format.
  • The section methods work with the v2 site embed, which is the default /siteembed since the 2026-10-02 cutover. Before that they needed path: 'siteembed-next'.
  • Additive; drop-in for 0.8.0 hosts. wander-embed.js still serves 0.8.0.

0.8.0 — 2026-09-29

Section titled “0.8.0 — 2026-09-29”

https://developer.wandermaps.com/sdk/wander-embed-0.8.0.js sha384-M/XWN3hEr2FuE3sJlje5LwwvaGvklgJRN6psDI0W6lBzQU03hT1eMa6LjxIeD5V4

  • Site embed: new validated path option for staging routes and an sdk=0.8.0 URL parameter.
  • New story-route methods: storyRoute(stops, options), storyRouteProgress(at) and clearStoryRoute().
  • New events: storyRouteLoaded, associationTypeSelected and associationTypeCleared.
  • New getEmbedVersion() method reports the version supplied by the embed’s ready payload.
  • New gettingHere widget with a Trip Race iframe and host-page attribution. It needs the /gettinghere page on wander-web, which is shipping separately.
  • wander-embed.js now serves this release.
  • Additive; drop-in for 0.7.x hosts.

0.7.1 — 2026-09-23

Section titled “0.7.1 — 2026-09-23”

https://developer.wandermaps.com/sdk/wander-embed-0.7.1.js sha384-GrP87/AQqfot4VXeIvWCLiae39xyYwRc/a/xOkfOYPLhdR+lok8ducTwShp9IPT9

  • Site embed: new associationsInCard option. Set it to false when the host renders associations itself.
  • Additive; drop-in for 0.7.0 hosts.

0.7.0 — 2026-09-17

Section titled “0.7.0 — 2026-09-17”

https://developer.wandermaps.com/sdk/wander-embed-0.7.0.js sha384-1CrKLeuX+qqz/SrIRDqWcSk7XrugrOvNZkQxMAwIKcIyOFVrTb7dw8g3tdw+YcFH

  • Site embed: fit option (initial camera fit) and showSearch option.
  • No new commands or events. Additive; drop-in for 0.6.0 hosts.

0.6.0 — 2026-09-05

Section titled “0.6.0 — 2026-09-05”

https://developer.wandermaps.com/sdk/wander-embed-0.6.0.js sha384-CAVgmx8husRmrdSpuTNoCUKTeKnHq0NcSjP6HmJ2b173xsThFmLKgCPb5Oke/t25

  • Site embed search bar.
  • New events: searchPerformed, searchResultSelected, externalPlaceSelected, externalPlaceCleared.

0.5.2 — 2026-09-03

Section titled “0.5.2 — 2026-09-03”

https://developer.wandermaps.com/sdk/wander-embed-0.5.2.js

  • New command highlight(poiId | null) and event associationHighlighted.
  • Association targets are drawn by decorating their own pin, never as a duplicate marker.
  • Note: the banner comment inside this file still reads “v0.5.1”; Wander.VERSION reports 0.5.2.

0.5.1 — 2026-09-03

Section titled “0.5.1 — 2026-09-03”

https://developer.wandermaps.com/sdk/wander-embed-0.5.1.js

  • Anchor / peek model: new commands focus, back, clearFocus; new event focusChanged.
  • New options fill, background, lazy; poiSelected carries source.

0.4.0 — 2026-09-02

Section titled “0.4.0 — 2026-09-02”

https://developer.wandermaps.com/sdk/wander-embed-0.4.0.js

  • Associations on select: new command getAssociations, new event associationSelected.

0.3.0 — 2026-09-02

Section titled “0.3.0 — 2026-09-02”

https://developer.wandermaps.com/sdk/wander-embed-0.3.0.js

  • New surface Wander.siteMap / Wander.siteEmbedUrl (the site embed).
  • New commands setContext, setMode, setPadding, hover; new options context, mode, padding.
  • New events contextApplied, poiHovered, poiUnhovered, clusterClicked.

0.2.0 — 2026-08-28

Section titled “0.2.0 — 2026-08-28”

https://developer.wandermaps.com/sdk/wander-embed-0.2.0.js

  • First versioned build. Wander.map / Wander.embedUrl for the list embed.
  • Commands flyTo, select, clearSelection, setActiveDay, fitBounds, plus setPois / setStops (reload the iframe).
  • Events ready, poiSelected, poiDeselected, boundsChanged, itineraryChanged, dayChanged, dimensionChanged, error.

Versioning policy

Section titled “Versioning policy”
  • The wire protocol between the SDK and the embed is separate from the SDK version and is currently 1 (Wander.PROTOCOL). New verbs are additive, so an older SDK keeps working against a newer embed.
  • https://developer.wandermaps.com/sdk/wander-embed.js serves the version marked latest in versions.json (currently 0.11.0). Pin a versioned file to get a specific build.
  • Minor versions (0.x.0) may add commands, events and options. They will not remove or rename existing ones without a note here.