Iframe scenarios

All iframe URLs use the base host https://web.wander-app.com. The examples use real places on the Explore Julian map (c2025939-af64-4371-a281-c6818b2cd96e), so each one works as pasted. Replace the map ID and the place, list and event IDs with your own. A map ID can be the map’s UUID or its slug. To see every surface below on one page, with live previews, visit Explore Julian’s embed kit.

List embed

Use /listembed/{mapId} to render a curated list or direct set of POIs on a map.

Parameter	Values	Default	Description
sb	List UUID	None	Loads the saved list; when both sb and pois are present, sb wins.
pois	Comma-separated POI UUIDs	None	Loads the specified POIs when sb is absent.
days	Comma-separated day numbers	All POIs on day 1	Assigns days positionally to pois; Day chips appear when the highest day is 2 or greater.
route	full	None	Enables the full animated route visualization.
routeType	driving, walking, cycling	driving	Sets the route’s travel mode.
showNumbers	true, false	false	Shows numbered badges on POI markers.
showAllPOIs	true, false	true	Shows or hides other POIs from the map outside the curated set.
showControls	true, false	true	Shows or hides navigation, geolocation, and recenter controls.
controlsPosition	top-left, top-right, bottom-left, bottom-right	bottom-right	Positions the map controls.
ns	String	default	Namespaces bridge messages. Give each embed on a page its own; see Namespaces.
z	Number	Auto-fit	Sets the initial zoom.
lat	Number	Auto-fit	Sets the initial center latitude.
lng	Number	Auto-fit	Sets the initial center longitude.
b	Number	Auto-fit	Sets the initial bearing.
p	Number	Auto-fit	Sets the initial pitch.

If you omit the camera parameters, the embed fits the POIs once on initial load. With direct POIs, keep days in the same order as pois; for example, pois=a,b,c&days=1,1,2 assigns the first two POIs to day 1 and the third to day 2.

<iframe
  src="https://web.wander-app.com/listembed/c2025939-af64-4371-a281-c6818b2cd96e?pois=b62841a3-7121-496d-888e-e36a6957bee7%2C55afc4f9-0702-4e82-bbab-45462396fa71%2C55937890-2b93-4df3-b78a-189fd9d52b21&days=1%2C1%2C2&route=full&routeType=driving&showNumbers=true"
  width="100%"
  height="500"
  style="border: 0"
  allow="geolocation"
  title="Two days around Julian"
></iframe>

Include allow="geolocation". Without it, visitor location falls back to coarse IP location and is excluded from movement analytics. See Attribution & analytics.

To turn the embed into a map of one page’s own listings rather than the whole destination, pass that page’s POI IDs and set showAllPOIs=false:

<iframe
  src="https://web.wander-app.com/listembed/c2025939-af64-4371-a281-c6818b2cd96e?pois=b62841a3-7121-496d-888e-e36a6957bee7%2C55937890-2b93-4df3-b78a-189fd9d52b21%2Cfdc78fee-9bc1-423e-8927-4650ab306674%2C48afa008-a75b-4644-aa01-ca34365bb9e6&showAllPOIs=false"
  width="100%"
  height="460"
  style="border: 0"
  allow="geolocation"
  title="State parks near Julian"
></iframe>

See Itineraries & listing maps for both patterns in full, including how to keep the map in step with filters and how to present it on mobile.

Site embed

Use /siteembed/{mapId} for a destination map that your site steers page by page. As a plain iframe it shows the whole map, and visitors can search, pan and open places:

<iframe
  src="https://web.wander-app.com/siteembed/c2025939-af64-4371-a281-c6818b2cd96e?mode=all&bg=%23ECE5D6&controlsPosition=bottom-right"
  width="100%"
  height="600"
  style="border: 0; display: block"
  allow="geolocation"
  title="Explore Julian map"
></iframe>

Add trailView=1 to open trails in Trail View, and pois= to start with a set of places lifted out. To change what the map shows without reloading it, drive it with Wander.siteMap or the bridge protocol. Every parameter is in the site embed’s URL table.

Full map embed

Use /{mapId} for the complete Wander map experience. This surface includes search, filters, a sidebar, POI details, events, authentication flows, and a built-in AI concierge panel.

Parameter	Values	Default	Description
lat	Number	Map default, then 0	Sets the initial center latitude.
lng	Number	Map default, then 0	Sets the initial center longitude.
z	Number	Map default, then 14	Sets the initial zoom.
b	Number	Map default, then 0	Sets the initial bearing.
p	Number	Map default, then 0	Sets the initial pitch.
t	Tag ID	None	Opens the map with a tag filter.
c	Category ID	None	Opens the map with a category filter.
sb	List ID	None	Opens a saved list.
poiId	POI ID	None	Opens a specific POI.
openNow	Boolean	None	Applies the open-now filter.
open24	Boolean	None	Applies the open-24-hours filter.
rangeD	Date value	None	Sets the date for an hours range filter.
rangeSt	Time value	None	Sets the start time for an hours range filter.
rangeEt	Time value	None	Sets the end time for an hours range filter.
v	Version ID	None	Loads the specified map version.
hideSignIn	true	Not hidden	Hides the Sign in button for partner-site embeds.

Camera values in the URL take precedence over the map’s saved defaults. If neither exists, the camera uses zoom 14, bearing 0, and pitch 0, centered at latitude 0 and longitude 0.

<iframe
  src="https://web.wander-app.com/c2025939-af64-4371-a281-c6818b2cd96e?poiId=b62841a3-7121-496d-888e-e36a6957bee7&lat=41.0240&lng=-77.6461&z=13&hideSignIn=true"
  width="100%"
  height="650"
  style="border: 0"
  title="Explore Julian"
></iframe>

Simple embed

Use /simpleembed/{mapId} for a minimal map focused on one POI with an Explore button.

Parameter	Values	Default	Description
poiId	POI ID	None	Selects the POI displayed by the embed.
lat, lng	Numbers	The POI’s location	Centres the map here instead. Send both.
z	Number	16 with a POI or lat/lng, else 14	Sets the initial zoom.
b	Number	Surface default	Sets the initial bearing.
p	Number	Surface default	Sets the initial pitch.
showControls	Boolean	Surface default	Shows or hides map controls.

<iframe
  src="https://web.wander-app.com/simpleembed/c2025939-af64-4371-a281-c6818b2cd96e?poiId=b62841a3-7121-496d-888e-e36a6957bee7&z=14&b=0&p=30&showControls=true"
  width="100%"
  height="420"
  style="border: 0"
  title="Bald Eagle State Park"
></iframe>

Events calendar embed

Use /eventsembed/{mapId} to add a map-free events calendar.

Parameter	Values	Default	Description
view	list, month, week	month	Selects the initial calendar view.
event_types	Comma-separated event types: music, food_drink, art, festival, market, family, outdoors, sport, class_workshop, nightlife, other	None	Filters the calendar to the specified event types.
date	YYYY-MM-DD	None	Opens the calendar at a date.
event	Event ID	None	Deep-links to an event.
branding	false	Shown	Hides the Wander wordmark when set to false.

<iframe
  src="https://web.wander-app.com/eventsembed/c2025939-af64-4371-a281-c6818b2cd96e?view=list&event_types=outdoors%2Cfamily"
  width="100%"
  height="700"
  style="border: 0"
  title="Events around Julian"
></iframe>

Getting-here widget

Use /gettinghere/{mapId} for the door-to-door trip comparison. It needs a getting-here configuration on the map, and the attribution link below the iframe is required. Wander.gettingHere adds both for you.

<iframe
  src="https://web.wander-app.com/gettinghere/c2025939-af64-4371-a281-c6818b2cd96e"
  title="Every way here, door to door — Wander Trip Race"
  allow="geolocation; clipboard-write; web-share"
  loading="lazy"
  style="display: block; width: 100%; height: 1100px; border: 0; border-radius: 14px"
></iframe>
<a href="https://www.wandermaps.com/?utm_source=dmo_embed&utm_medium=trip_race_sdk&utm_campaign=c2025939-af64-4371-a281-c6818b2cd96e"
   target="_blank" rel="noopener nofollow">Trip planner by Wander</a>

Which surfaces talk to your page

Surface	Bridge	Notes
List embed	Yes	Commands and events in the Embed SDK.
Site embed	Yes	The full bridge protocol.
Full map, simple embed, events calendar, getting-here	No	Configure them with URL parameters only. They send no events.

Legacy URLs

/betaembed/{mapId} redirects to /{mapId} and preserves its query parameters. The older /embed?mapId= form also redirects and translates its legacy parameter names. Both remain supported, but use the current URL patterns for new integrations.