MapAPlace handbook

Module switched ONThe module becomes active for this map.

→

Editor panel becomes availableYou can configure that module.

→

Published feature can runSaved output appears after publishing.

Camera and setting changes appear in the editor immediately where noted, but visitors see saved changes only after the map is published.

Free version

The features and limits included in MapAPlace now.

Start here

Setting	Editor effect	Published map effect	When empty or off
IncludedMaps Up to 3 maps	EditorCreate and manage up to 3 maps from your account.	PublishedEach published map has its own public link.	LimitThe free account limit prevents creating a fourth map.
IncludedMarkers and Categories Up to 100 markers per map	EditorAdd and organise up to 100 markers and their categories.	PublishedPublished markers use their saved content, category and style.	Free onlyPremium or planned modules are not documented as part of the free editor.
WorkflowSave · Preview · Publish	EditorSave draft changes, preview the visitor view, and decide when to publish.	PublishedVisitors continue seeing the last published revision until you publish again.	DraftUnsaved or unpublished changes are not shown at the public link.
GuideUse cases	EditorOpen Use cases for setup ideas for a store finder, indoor shopping centre, treasure hunt or custom forest trail map. Each guide identifies the relevant extensions.	PublishedBuild the map around your locations, floor plans or trail artwork, then publish it for visitors.	Setup guideUse-case guides do not automatically create a map or enable premium extensions.

Module switches

Markers and Categories are included with every map.

Map modules

Setting	Editor effect	Published map effect	When empty or off
Markers Enabled by default	EditorThe Markers panel and Markers settings are available.	PublishedSaved markers can appear on the published map.	OffThe marker panel and marker layer are inactive.
Categories Enabled by default	EditorThe Categories panel and marker category selector are available.	PublishedAssigned marker categories can provide shared styling.	OffCategory controls are unavailable and saved category assignments are inactive.

Map settings

Controls the saved Camera view, standard-map detail and the controls available to visitors.

Always available

Setting	Editor effect	Published map effect	When empty or off
TextMap name Required · Maximum 160 characters	EditorNames the map in the editor and map list.	PublishedIdentifies the map wherever the publishing integration displays its name.	RequiredA map requires a name before it can be saved.
Use kilometres OFF uses miles	EditorDistance settings and previews use kilometres. This control appears above Zoom Buttons.	PublishedFilter distances and the Distance Scale are shown and calculated in kilometres.	OffFilter distances and the Distance Scale use miles.
SliderZoom Settings preview mode	EditorUpdates the live Camera view preview and follows zoom changes made directly on the map.	PublishedSets the saved loading zoom for the published map.	Not savedThe preview value is not retained until Save Camera View is selected.
SliderTilt Settings preview mode	EditorTilts the live Camera view preview from top-down to an angled view and follows map tilt changes. You can also hold the right mouse button, or Ctrl with the left mouse button, and drag vertically to tilt without opening Settings. Drag horizontally to rotate.	PublishedSets the saved loading tilt for the published map.	Edit modeClosing Settings returns the editor to top-down mode without discarding the saved tilt.
SliderBearing Settings preview mode	EditorRotates the live Camera view preview and follows bearing changes made directly on the map.	PublishedSets the saved loading direction for the published map.	Edit modeClosing Settings returns the editor to north-up mode without discarding the saved bearing.
ActionSave Camera View	EditorSaves the current map centre, Zoom, Tilt and Bearing, then saves and publishes the map.	PublishedDefines the published map's default loading camera.	Not savedCamera preview changes remain temporary until this action is selected.
Zoom Buttons	EditorNo additional settings appear.	PublishedThe zoom-in and zoom-out buttons are shown.	OffThe buttons are hidden; supported touch, wheel and gesture zoom can still work.
Fullscreen Button	EditorNo additional settings appear.	PublishedVisitors can expand the map to fullscreen.	OffThe fullscreen button is hidden.
Distance Scale	EditorNo additional settings appear.	PublishedA distance scale is displayed and updates with the zoom level.	OffThe distance scale is hidden.
Basemap POIs	EditorStandard basemap points of interest are visible while editing.	PublishedPoints and labels supplied by the standard basemap are shown.	OffThe standard basemap points of interest are hidden.
Basemap buildings Standard basemap detail, not the Buildings module	EditorThe Basemap 3D buildings option becomes available.	PublishedBuildings supplied by the standard basemap are visible.	OffStandard basemap buildings are hidden.
Basemap 3D buildings Basemap buildings ON	EditorSupported standard basemap buildings can be previewed in 3D.	PublishedSupported standard basemap buildings are extruded in 3D.	OffStandard basemap buildings remain visible but flat.
Set Bounds	EditorShows draggable southwest and northeast bounds on the map. Turning it on first uses the current view.	PublishedVisitors cannot pan the published map outside the saved bounds.	OffThe bounds are not enforced, but the saved corners are retained.
JSONMap style Save and publish after applying	EditorOpen Map style in Settings, paste Style JSON and select Apply style. The Open Maputnik style editor link opens the external editor in a new tab. When possible, Apply style extracts only changes from the default map; otherwise it retains the full valid style. Unfinished JSON is preserved during unrelated settings changes.	PublishedThe published map uses the saved custom basemap style alongside its marker and extension layers.	Default styleApply an empty Style JSON field to restore the default basemap. Invalid JSON reports an error without replacing the saved style.
ActionSet Bounds To Current View Set Bounds ON	EditorReplaces the saved bounds with the map area currently in view.	PublishedThe updated bounds apply after the map is saved and published.	HiddenThe action is hidden until Set Bounds is enabled.

Markers

Creates markers and controls their initial fit, content, category and style. Shared popup content is configured in the separate Popups panel.

Markers module ON

Setting	Editor effect	Published map effect	When empty or off
Fit map to markers Markers settings	EditorSaves the published-map preference without moving or zooming the editor camera when markers are selected or edited.	PublishedOpens the published map fitted around all saved markers.	OffThe saved Camera view controls the initial loading position.
AddAdd marker	EditorCreates a marker on the map and opens its settings. The marker list remains alphabetical while Categories retain their authored order.	PublishedThe saved marker appears at its chosen position after publishing.	UnusedNo marker is created until the action is selected.
TextTitle Required · Maximum 160 characters	EditorNames the marker in the list and supplies its title content.	PublishedCan be shown in the marker popup when that field is enabled.	RequiredA marker requires a valid title.
TextareaDescription Maximum 10,000 characters	EditorStores optional descriptive marker content.	PublishedCan be shown in the popup when Description is enabled.	EmptyNo description is added to the popup.
URLLink HTTP or HTTPS · Maximum 2,048 characters	EditorStores an optional HTTP or HTTPS destination.	PublishedCan be shown in the popup when Link is enabled.	EmptyNo link is added to the popup.
Style	EditorShows the marker’s custom Shape, Icon, Icon text and Colour controls.	PublishedThe marker uses its custom style before category or default marker styling.	OffThe marker falls back to an enabled category style and then the marker defaults.
StyleMarker appearance Style ON	EditorSets shape and border radius, icon or short icon text, plus fill, border and text colours. Border radius updates after the slider is released.	PublishedThe marker is drawn with the effective saved appearance.	UnavailableUnavailable while the marker Style switch is off.
Popup	EditorShows the marker's own popup field switches and Always stay open control. Available fields and their order come from Popups settings.	PublishedSelecting the marker can open its configured popup.	OffNo popup is attached to that marker.
OrderPopup content Popup ON	EditorChooses which shared fields this marker uses. Add, remove and reorder fields in the separate Popups panel rather than Markers settings.	PublishedEnabled fields with saved values appear in the same order.	EmptyNo authored marker fields are added to the popup.

Categories

Organises markers and supplies shared marker styling.

Categories module ON

Setting	Editor effect	Published map effect	When empty or off
Show legend	EditorAvailable from the Categories settings button.	PublishedShows the saved Categories legend directly below the map.	OffThe Categories legend is hidden.
Hide empty Show legend ON	EditorControls whether unassigned Categories appear in the legend.	PublishedCategories without an assigned active map item are omitted from the legend.	OffAll saved Categories appear in the legend.
AddAdd category	EditorCreates a category and opens it for editing.	PublishedThe category affects markers only after it is assigned and configured.	UnusedNo category is created.
TextName Required · Maximum 120 characters	EditorNames the category in the category list and marker selector.	PublishedIdentifies the saved category used by assigned markers.	RequiredA category requires a valid name.
StyleMarker style	EditorSets the shared shape, border radius, icon and colours for markers assigned to this category.	PublishedAssigned markers use the category style unless their own Style is enabled.	FallbackAssigned markers fall back to their custom style or the marker defaults.
SelectCategory Inside each marker	EditorAssigns the current marker to a category. No category clears the assignment.	PublishedThe marker can use the selected category’s shared style.	No categoryThe marker has no category assignment.

Popups

The separate Popups panel follows Categories and Markers settings. Its title switch controls all location popups, and Show popups on hover appears before Popup content.

Shared map settings

Setting	Editor effect	Published map effect	When empty or off
Popups	EditorUse the switch beside the panel title to enable or disable location popups for the map without removing markers, Buildings or saved popup content.	PublishedEnabled locations can show their configured popups. This main switch also applies to Post Type Markers in WordPress.	OffLocation popups are closed and disabled, including popups marked Always stay open. Saved content and individual popup choices are retained for when the switch is turned back on.
Show popups on hover OFF by defaultPopups ON and the location popup enabled	EditorEnables temporary popup previews when the pointer enters an enabled location. Hover does not select the location or move the camera. Building positioning and shape editing suppress hover previews.	PublishedHover opens a popup and hover out closes it. Clicking the hovered location keeps its popup open and follows the existing click and zoom behavior. Hovering another location opens a second temporary popup alongside the clicked one; leaving it closes only that temporary popup. Clicking another location replaces the clicked popup, and clicking outside closes it.	OffLocations retain normal click behavior; moving the pointer over them does not open a popup. Turning hover off closes temporary hover popups while keeping clicked popups open.
OrderPopup content Popups ON	EditorAdd, choose and reorder the shared fields here. Ordinary markers offer their own switches for these fields. Buildings inherit the selected shared fields and order instead of maintaining a separate content builder on each level or Building.	PublishedSelected fields with saved values render in the configured order. Available content depends on the enabled modules and the location's representation.	No contentEmpty optional values are omitted. Post Type Markers have their own Popup content list rather than inheriting this list.
Always stay open Individual Popup ON and main Popups ON	EditorAn individual marker or Building can keep its own popup open automatically. This control belongs to that location's Popup settings, not the shared Popups panel or level defaults.	PublishedThese popups can coexist and remain open through hover out and clicks elsewhere. They are independent of the temporary hover and ordinary clicked popup behavior.	OffThe location uses ordinary click behavior and optional hover previews. The main Popups switch still takes priority when Always stay open is enabled.

Public access

Controls whether visitors need a password before the map opens.

Setting	Editor effect	Published map effect	When empty or off
Password protect map	EditorThe password field appears and requires 8–128 characters.	PublishedVisitors must enter the saved password before the map loads.	OffThe public map has no password gate.
PasswordPassword Password protect map ON	EditorSets or replaces the password. Leaving it blank on an already protected map keeps the current password.	PublishedA successful password unlock grants access to that map for up to eight hours.	RequiredA new protected map cannot be saved without a password.

Save, preview and publish

Controls which revision is private and which revision visitors can see.

Publishing workflow

Setting	Editor effect	Published map effect	When empty or off
ActionSave	EditorCreates or updates the saved draft revision.	PublishedSaving alone does not replace the currently published revision.	Not savedUnsaved editor changes remain local to the current editing session.
ActionPreview	EditorOpens the visitor view of the saved map without publishing it.	PublishedThe public link remains unchanged.	Save firstSave the map before previewing.
ActionPublish	EditorMakes the saved revision the current public revision.	PublishedThe public map link displays that published revision.	DraftLater draft changes stay private until they are published.

Map files and SVG export

Use Settings to transfer map content or export the current view as artwork.

Setting	Editor effect	Published map effect	When empty or off
FileDownload map file	EditorDownloads a self-contained JSON file with map settings, Markers, Categories, Buildings, filters, extension data and uploaded images.	PublishedDownloading a file does not change the published map.	No fileA map file must be downloaded before it can be imported elsewhere.
FileImport map file	EditorSelect a map JSON file and confirm Replace map contents. Import replaces the destination draft's settings and content while preserving its own name and public link. Modules unavailable to the destination remain inactive.	PublishedVisitors continue seeing the published revision until the imported draft is published.	CancelledCancelling the confirmation or an invalid import leaves the existing map content in place.
SVGSave map (SVG)	EditorExports the current map view with separate Background map, Decoration and Buildings groups. Supported geometry, colours and outlined text remain vector artwork; the export reports unsupported content or omissions.	PublishedThe download is a static artwork file; it does not include interactive popups or visitor controls.	Export unavailableAn export failure reports the problem and can be retried without replacing the map.

Accounts, subscriptions and purchases

Web-app subscriptions and WordPress plugin purchases provide different types of access. Prices are in pounds sterling; the checkout shows the current price before payment.

Access and billing

Setting	Editor effect	Published map effect	When empty or off
AccountCreate account / Login	EditorCreate a MapAPlace account or sign in before buying access. Your account holds web-app subscriptions and purchased WordPress downloads.	PublishedAn account is not required to view an ordinary published map. Password-protected maps require their own map password.	Sign in firstWithout an account, premium access and purchased downloads cannot be assigned to you.
SubscriptionWeb-app extensions £3 per extension per month	EditorOpen Premium extensions to subscribe to Filters, Buildings, Custom Basemap, Routes and navigation, Custom routing or Treasure Hunt. Each extension is £3 per month.	PublishedAn active subscription provides access to that extension in the hosted web app; it does not purchase a WordPress plugin ZIP.	Free featuresThe free Markers and Categories editor remains available within its account limits.
BundleAll web-app extensions £12 per month	EditorChoose the £12 per month bundle for access to all six hosted extensions. Post Type Markers belongs to WordPress and is not part of the hosted bundle.	PublishedExtensions covered by the bundle display Included in your bundle rather than another purchase action.	Manage existing subscriptionsBuying the bundle does not cancel existing individual subscriptions. Manage those in your account to avoid overlapping charges.
TrialExtension free trials	EditorEligible individual hosted extensions offer a 7-day free trial without a credit card. Start the trial from its extension card; a used trial cannot be started again for that plan.	PublishedTrial access enables the extension while the trial is active. Choose Subscribe for continued paid access.	Trial endedAn expired trial no longer grants that extension. The all-extensions bundle has its own purchase option.
ManageAccount purchases and subscriptions	EditorUse Account to review purchased access and manage active subscriptions. Follow the available cancellation or billing-management actions for the selected subscription.	PublishedPayment confirmation may take a short time. Purchased WordPress downloads unlock after confirmation; return to the plugins page while signed in.	Payment not completedLeaving checkout or cancelling a payment does not grant access.

WordPress integration

These content options apply when the corresponding WordPress plugins are installed; they are separate from the hosted editor's ordinary marker content.

WordPress integration

Setting	Editor effect	Published map effect	When empty or off
DownloadWordPress plugins and bundle	EditorOpen WordPress plugins to download the free Core, buy an individual premium extension for £39, or buy the all-extensions bundle for £199. These are one-time purchases through your MapAPlace account.	PublishedAfter payment confirmation, sign in to download purchased plugin ZIPs. The bundle unlocks Filters, Buildings, Custom Basemap, Routes and navigation, Custom routing, Post Type Markers and Treasure Hunt. Buy bundle appears on the bundle card.	Purchase requiredWordPress purchases are separate from hosted map subscriptions. Unpurchased premium downloads remain locked.
InstallCore and extension dependencies	EditorUpload and activate Core before installing extensions for locally created WordPress maps. Custom routing also requires Routes and navigation. Connector is free, works independently of Core and is not a premium extension purchase.	PublishedLocal maps render from WordPress-owned map data. Install the corresponding add-ons for the premium features used by those local maps.	Separate productsA hosted subscription does not grant purchased WordPress extension downloads; a WordPress purchase does not grant hosted subscription access.
OrderPost Type Markers — Popup content WordPress Post Type Markers plugin	EditorChoose and order fields in the Post Type Markers settings. This list is independent of the shared Popups content list and can include Title, Description, Featured image, Post Type Marker post link and additional site-provided fields.	PublishedMarkers generated from posts show the selected post content. The main Popups switch and Show popups on hover still apply to them.	Separate contentChanging the shared Popup content list does not replace the Post Type Markers content list.
LinkBuilding post link WordPress Buildings plugin	EditorThis field refers to the WordPress post assigned to a Building. Enable it in shared Popups content when the Buildings plugin provides it.	PublishedThe Building popup can link to its assigned post.	No linked postNo assigned-post link appears without the field and a valid linked post.
LinkPost Type Marker post link WordPress Post Type Markers plugin	EditorThis field refers to the source post that generated a Post Type Marker. Select it in that module's own Popup content settings.	PublishedThe generated marker popup can link to its source post. This is a different destination from a Building's assigned post.	No post linkNo source-post link appears when the field is omitted or the post has no valid URL.
DisplayCategory accordion WordPress Filters integration	EditorThe WordPress category accordion groups marker locations by category and uses natural case-insensitive marker name ordering, so Marker 2 comes before Marker 10.	PublishedCategory choices filter markers; Buildings are not filtered by this marker-only accordion.	Separate displayThe hosted editor's Category settings and optional map filter controls remain separate from this WordPress display.

MapAPlace Connector

Display published maps from your web-app account directly on a WordPress page. Connector renders the interactive map on the WordPress side and keeps its private connection credential on the server.

Free WordPress connection

Setting	Editor effect	Published map effect	When empty or off
ConnectWordPress connections	EditorIn the web app, open Account > WordPress connections and select Create connection URL. Copy the complete URL. In WordPress, open the top-level MapAPlace Connector admin page and paste it to connect. With Core installed, Connector appears immediately after its admin menu.	PublishedThe connected account supplies the list of published web-app maps available to WordPress editors.	Connect firstA disconnected site cannot list or render connected maps. Generate a fresh connection URL if the previous one has expired or has already been used.
BlockLocal maps and Connected maps Core and Connector active	EditorWith Core active, add its normal Map block. The sidebar map selector groups Local maps created in WordPress and Connected maps published in your web-app account. Choose a map from the appropriate group.	PublishedThe selected source determines which map is rendered, even when a local map and a connected map have the same identifier.	Published maps onlyDraft, deleted or unpublished web-app maps are unavailable in Connected maps.
BlockConnector without Core	EditorWithout Core, Connector registers its own MapAPlace webapp map block. Add it to a page or post and choose a connected map in its sidebar.	PublishedThe standalone block uses the same native viewer, published-map checks and password protection as a connected map selected through Core.	Hosted maps availableCore is required to create and edit local WordPress maps, but is not required to display connected maps.
ViewConnected map camera view	EditorPan, zoom, tilt or rotate the connected preview, then save or update the WordPress page to store that block's starting view. Each block can have its own camera. Selecting a different map clears the previous camera override.	PublishedThe block uses its saved camera view. Without an override, it fits the published markers when Fit map to markers is enabled, otherwise it uses the published web-app map's camera settings.	Published camera defaultChanging a connected block's camera does not change the web-app map or another block. Local maps keep Core's own camera-saving workflow.
DisplayNative WordPress map rendering	EditorPreview the interactive map directly in Gutenberg and set the block height to suit the page. Edit the connected map's locations, settings and extension content in the web app.	PublishedThe viewer runs on the WordPress page and loads published map data through Connector. It does not embed the hosted map page in an iframe. Visitor popups, hover behavior and enabled extensions come from the published map.	Map unavailableAn unavailable connection or map displays an unavailable state rather than draft content.
PublishAutomatic connected map updates	EditorSave your changes in the web app, then Publish to update the visitor version. The app sends a map-change notification to the connected WordPress site; no manual Resync action is required.	PublishedConnected viewers refresh when a changed published map is available. An open viewer retains its current camera while updating. Unpublished draft changes remain private.	Unavailable or offlineNotifications are retried if WordPress is temporarily unreachable. If the map is unpublished or the connection is removed, the viewer stops displaying it.
AccessConnected map passwords and privacy	EditorKeep the complete connection URL private. Connector stores its credential encrypted in WordPress; it is not saved in block attributes or exposed to visitors.	PublishedPassword-protected maps still request the map password. Connecting a WordPress site does not bypass publication or password checks.	Access requiredA missing password or unavailable publication prevents map content from loading.
DisconnectRemove a WordPress connection	EditorUse Disconnect in Account > WordPress connections or on the WordPress Connector page to remove the connection. The retired MapAPlace Sync plugin and its Not synchronized yet status are no longer part of this workflow.	PublishedConnected blocks become unavailable after disconnecting. Maps created locally with Core remain WordPress-owned.	Connection removedReconnect with a fresh connection URL when you want to display web-app maps on that site again.

Filters

The premium Filters extension configures the filtering bar shown directly above the map.

Premium · Filters module ON

Setting	Editor effect	Published map effect	When empty or off
Location and distance	EditorShows the Default distance control in the selected Map distance unit.	PublishedShows location search, browser geolocation, the distance slider, selected-location marker and distance circle.	OffLocation search, current location and distance controls are hidden.
SearchLocation search Location and distance ON	EditorNo additional saved setting is required after Location and distance is enabled.	PublishedThe location field first shows an inline Enable location search control. After the visitor reviews the short privacy notice and enables it, the control is replaced by the focused search input. The terms link identifies Photon as the location search provider. Selecting a result sets the filter origin.	Consent firstNo search text is sent to the location search provider until the visitor enables location search. The inline consent control is hidden while Location and distance is off.
ActionUse my location Location and distance ON · Browser permission	EditorNo visitor location is stored with the Map.	PublishedThe crosshair button requests browser geolocation and uses the returned position as the filter origin.	UnavailableIf geolocation is unavailable or permission is not granted, the Map reports that status and keeps the previous filter state.
SliderDefault distance Location and distance ON	EditorSets the initial visitor radius; its miles or kilometres label follows Map options.	PublishedThe selected radius is converted to one canonical distance before marker calculations.	HiddenUnavailable while Location and distance is off.
Map markerSelected location marker Location and distance ON · Location selected	EditorNo marker is saved to the Map; it belongs only to the current visitor's filter session.	PublishedA blue marker shows the selected or current location. Visitors can drag it to choose a custom origin and immediately recalculate the results.	No originThe marker is hidden until a location is selected and is removed by Reset or when Location and distance is off.
Map overlayDistance circle Location and distance ON · Location selected	EditorUses Default distance and the Map's miles or kilometres option.	PublishedA blue circle shows the real-world filtering radius around the selected location and updates as the distance slider moves.	No originThe circle is hidden until a location is selected and is removed by Reset or when Location and distance is off.
Categories	EditorShows the Allow multiple setting.	PublishedVisitors can filter markers by their saved category.	OffThe category filter is hidden.
Allow multiple Categories ON	EditorConfigures category choices as multi-select.	PublishedVisitors can combine several category choices; markers matching any selected category remain visible.	OffVisitors can select one category at a time.
ActionReset	EditorNo saved settings are changed.	PublishedClears the visitor's location and category choices and restores the default distance.	HiddenThe action is unavailable when no filter controls are enabled.

Routes and navigation

The premium Routes and navigation extension creates fixed saved routes between routable places and provides optional visitor routing and live navigation from a visitor's current location.

Premium - Routes and navigation module ON

Setting	Editor effect	Published map effect	When empty or off
Front end navigation Front end routing ON	EditorKeeps live navigation available after a visitor previews a route. This setting is on by default.	PublishedA ready visitor route can offer Start navigation, follow the visitor's live location and show journey instructions and progress.	OffStart navigation and live journey progress are unavailable. Fixed saved route lines can still appear.
Front end routing	EditorKeeps visitor route previews available from routable place popups. This setting is on by default.	PublishedSuitable place popups show Show route and calculate a visitor route from the visitor's current location using the configured routing strategy.	OffVisitor route actions are hidden and live navigation is unavailable. Fixed saved route lines can still appear.
SelectRouting provider	EditorSelects OpenStreetMap (OSRM), OpenRouteService / HeiGIT or Google Maps for provider-calculated routes. Changing it recalculates affected saved routes in the editor.	PublishedHandles new visitor route requests when Front end routing is on. Already saved fixed route lines use their published geometry without querying the provider again.	UnavailableProvider routes cannot be calculated while the selected provider is unavailable or incorrectly configured.
SecureRouting provider API key Provider requires a credential	EditorSaves or removes the selected provider's map-specific credential. The editor reports whether it is configured without revealing the stored key.	PublishedAuthorises provider requests that require a credential; the saved key is never included in published map content.	MissingOpenRouteService or Google Maps route calculation fails until a valid key is saved. OSRM does not require a key but its public endpoints have stricter limits.
SelectDefault route type Walking - Cycling - Driving	EditorChooses Walking, Cycling or Driving for each newly created saved route.	PublishedVisitor route previews start with the saved default route type when provider routing is used.	WalkingWalking is used when no different default is saved.
AddAdd route At least two routable places	EditorCreates a fixed saved route that can be named, styled and built from ordered places and waypoints. Up to 50 routes can be stored on one map.	PublishedA completed saved route line appears using its stored geometry, independently of the visitor routing and navigation switches.	UnavailableThe action is unavailable until at least two routable places exist or the map already contains 50 routes.
DetailsName and Route type Inside each saved route	EditorNames the saved route and selects Walking, Cycling or Driving for its calculated path.	PublishedThe saved travel mode determines the fixed path calculated in the editor; the route retains its own name and settings.	IncompleteA route still needs at least two resolved points before geometry can be calculated.
StyleColour, Line width and Stroke width	EditorControls the saved route colour and line widths. Stroke width is available for Walking and Cycling routes.	PublishedThe fixed route line is drawn using the saved style.	DefaultsThe route uses its default line styling.
PointsAdd place and Add waypoint	EditorAdds existing routable places as stops, including the same place more than once, or adds intermediate waypoints by clicking the map. Points can be moved up, moved down or removed, and their saved order defines the journey.	PublishedThe fixed route passes through every resolved place and waypoint in the saved order.	IncompleteA route with fewer than two resolved points cannot be calculated. Each route supports up to 25 points.
Saved dataCalculated route geometry	EditorCalculates route geometry when the provider, route type, ordered points or custom routing strategy changes, then stores cacheable geometry with the map.	PublishedPublished fixed routes render from the stored geometry and do not contact the routing provider just to load the map.	Not calculatedA changed or invalid route remains incomplete until route calculation succeeds.
OrderSaved routes	EditorReorders saved routes in the panel or removes a route from the map.	PublishedRemoved route lines disappear; remaining routes retain their own points, geometry and styles.	EmptyNo fixed route lines appear when the list is empty.

Custom routing

The standalone premium Custom routing extension adds an SVG routing strategy to Routes and navigation. It requires Routes and navigation, but it does not require or belong to Custom Basemap.

Premium - Custom routing and Routes modules ON

Setting	Editor effect	Published map effect	When empty or off
Hybrid routing Custom routing and Routes and navigation modules ON	EditorConnects the custom SVG network to the public provider selected under Routes and navigation. This setting is on by default.	PublishedSaved and visitor routes can combine the custom network with provider-calculated sections when a connection is available.	OffRoutes use only the SVG network. The public provider is not called and off-network endpoints use straight connector lines to the chosen custom-network points.
UploadRouting SVG SVG only - Maximum 5 MiB	EditorUploads a validated SVG routing network up to 5 MiB. If Custom Basemap artwork exists its bounds are used initially; otherwise the current map view is used.	PublishedThe routing engine follows supported paths in the saved and geographically placed SVG; the network preview itself is not published as visitor artwork.	EmptyCustom routing has no network to follow, so Routes and navigation continues with its selected provider.
Map editCreate or Edit routing SVG	EditorOpens the vector editor over the map to draw paths, select existing paths, move points and curve handles, finish or cancel drawing, and save a new managed Routing SVG.	PublishedSaved path changes define where custom routes can travel after the map is saved and published.	UnchangedClosing without saving leaves the current managed Routing SVG unchanged.
ActionDownload routing SVG Routing SVG uploaded or created	EditorDownloads the current managed routing network for inspection, backup or editing elsewhere without changing the map.	PublishedDownloading has no published map effect.	HiddenThe action is hidden until a Routing SVG exists.
Preview routing network Routing SVG uploaded or created	EditorDraws the SVG network over the editor map for alignment checks and shows move and scale handles while the Custom routing panel is open.	PublishedThe editor-only routing-network preview and placement handles are never published.	OffThe editor overlay and placement handles are hidden without disabling custom route calculation.
HandlesMove and scale routing artwork Preview routing network ON	EditorMoves or scales the placed routing network directly on the map. When the separate Custom Basemap extension is also installed and has artwork, the shared placement keeps both aligned.	PublishedCustom routes use the saved geographic placement; linked Custom Basemap artwork keeps its corresponding saved placement.	Optional linkCustom Basemap remains entirely optional, and Custom routing works with a Routing SVG on its own.
EditorCreate or Edit routing SVG Custom routing ON	EditorOpens the routing SVG editor in a flat map view and turns off the Buildings 3D preview. The SVG remains aligned with its saved geographic bounds as the camera changes. Save replaces the managed routing SVG; closing without saving keeps the previous network.	PublishedRoutes use the saved network after publishing, without showing editing handles.	Not savedUncommitted edits do not replace the routing network.

Custom basemap

The separate premium Custom Basemap extension places uploaded map artwork above the standard basemap or on its own. It does not include, own or require Custom routing.

Premium - Custom basemap module ON

Setting	Editor effect	Published map effect	When empty or off
Show standard base map	EditorShows the normal basemap beneath the uploaded artwork.	PublishedVisitors see the standard basemap below the saved custom image.	OffThe standard basemap is hidden and the saved Map background colour fills uncovered areas.
ColourMap background colour Show standard base map OFF	EditorSets the map background visible behind and around the uploaded artwork.	PublishedFills uncovered map areas when the standard basemap is off.	HiddenThe control is hidden while Show standard base map is on.
UploadMap image SVG - JPG - PNG - WebP - Maximum 5 MB	EditorUploads a safe SVG, JPG, PNG or WebP image up to 5 MB and fits its aspect ratio into the current map view.	PublishedDisplays the saved artwork at its saved geographic placement. SVG artwork is rerendered for the current zoom so it remains sharp.	EmptyNo custom image is drawn.
HandlesMove, scale and rotate artwork	EditorDrag the round centre handle to move the artwork, the square corner handle to scale it without stretching, and the orange handle to rotate it.	PublishedVisitors see the resulting saved placement without editing handles.	UnavailableHandles are shown only while the Custom basemap panel and an uploaded image are active.
ActionFit image to current view	EditorRepositions and scales the uploaded image inside the current map view while preserving its aspect ratio.	PublishedUses the newly saved placement after publishing.	HiddenThe action is hidden until a Map image is uploaded.
Fit view to basemap Map image uploaded	EditorSaves whether the published map should open around the complete custom basemap; it does not change image placement.	PublishedOpens the published map fitted to the complete uploaded basemap.	OffThe normal saved camera and marker-fit settings control the initial view.

Buildings

The premium Buildings extension creates marker-like places with SVG footprints, organised into positioned levels and rendered as interactive 2D or 3D Buildings.

Premium - Buildings module ON

Setting	Editor effect	Published map effect	When empty or off
ActionLevels settings	EditorThe gear in the Levels header opens Show buildings in 3D, Show level selector and Show building directory. The 3D preview button stays last in the editor's top-right map-control stack.	PublishedThese settings control 3D extrusion and the visitor controls shown at the top left of the published map. The level selector appears only when at least two levels exist.	OffEach visitor control is hidden when its setting is off; the saved Building and level data is retained.
AddAdd level	EditorCreates Ground floor first, followed by Level 1, Level 2 and later numbered levels. Level cards remain collapsed until opened.	PublishedA saved level can contain its own Buildings and becomes available to the level selector.	No levelsNo level or Building drawing surface exists until a level is added.
TextLevel name	EditorNames the level in the Levels panel and the synchronized Building level selector.	PublishedNames the level in the top-left level selector and grouped Building directory.	RequiredEvery level requires a name.
Default level	EditorChooses the level used when the map first loads.	PublishedThe published map initially displays the selected default level.	OffAnother saved level remains the default.
ActionBuildings default settings	EditorThe gear before a level's delete button opens separate Show name, Style and Popup defaults. Style contains only Fill, Hover, Active, Outline, Height, Hover height and Opacity. The toggleable Show name panel contains Text, Text hover, Text active, Horizontal offset, Vertical offset, Rotation, Title size and Subtitle size from 1 to 1000.	PublishedBuildings on that level inherit its style unless an enabled Category style or custom Building style overrides it. Popup fields and order come from the shared Popups settings, while the level's Popup switch can disable popups for that level.	Show name offTurning Show name off hides its name controls and removes roof names while preserving their saved values.
FileImport Buildings SVG	EditorImports each supported item inside one group named Buildings, or each supported top-level SVG shape or group, as one Building. A single level import can therefore create multiple Buildings and is fitted to the map in Web Mercator without stretching its aspect ratio. A Label group (also Label1, Label_1 or Label-1) inside a Building becomes its logo; Decorations becomes the level decoration layer. When Custom routing is active, a Routes group becomes the matching routing SVG and is excluded from Building geometry. Optionally select a GeoJSON file with matching GeoPositioning feature IDs to place the level geographically.	PublishedImported Buildings render in their saved level placement and retain multi-part shapes and holes.	Invalid SVGWhen a Buildings group exists, unrelated content outside it is ignored. Multiple groups named Buildings, unsupported executable content, or SVGs without measurable Building geometry are rejected.
NumberLevel rotation	EditorRotates the complete level drawing surface and all of its Buildings around the SVG centre.	PublishedThe published Building footprints use the same saved rotation.	0 degreesA zero value keeps the imported SVG orientation.
ActionPosition level	EditorShows the distinct v1-style move, resize and rotation handles for the complete level on the map.	PublishedVisitors see the resulting saved level placement without editing handles.	FinishedNo positioning handles are shown.
AddDraw building	EditorCreates a Building and opens the shared SVG editor directly on the map. New points, draggable anchors and edge midpoint handles snap to nearby points and edges on other visible Buildings on the same level. Hold Shift while dragging a corner anchor to keep its adjoining walls perpendicular at 90 degrees; release Shift for free movement. Use Save building to keep the finished shape.	PublishedThe saved shape appears as a Building after the map is published.	Not savedUnsaved editor geometry is discarded only after confirmation.
FieldsTitle, Subtitle, Category, Description and Link	EditorStores marker-like Building content with Subtitle immediately after Title and optionally assigns the Building to a Category. Title and Subtitle have independent sizes but share text positioning. Selecting a Building on the map changes to its level, focuses it without an excessively close zoom and reveals its sidebar item; selecting empty map space clears the selection.	PublishedThe whole 2D footprint or 3D Building body is interactive. The title identifies the Building and enabled popup fields can show its description and link.	EmptyEmpty optional fields are omitted from the popup.
Hide Building	EditorRetains the Building record but removes it from the active map layer and snap targets.	PublishedThe Building is absent from the map and directory.	OffThe Building is visible on its level.
ImageLogo or image	EditorUpload an image for the Building. Keep original colours preserves the uploaded logo colours instead of tinting SVG artwork. Logo positioning provides independent offsets, Rotation and Size from 1 to 1000, plus Position logo, without moving the title. With a logo, Subtitle rotation ranges from -360 to 360 degrees; 0 keeps automatic alignment.	PublishedThe saved logo and subtitle appear with the Building. Overlapping artwork can remain attached to its roof rather than rising merely because its anchor crosses the footprint edge.	No imageWithout an image, the Building uses its configured title and subtitle presentation.
Interactive	EditorKeeps the Building available for selection and popup testing.	PublishedVisitors can select the Building and open its configured popup.	OffThe Building remains visible but does not open a popup.
Style	EditorEnables custom Fill, Hover, Active, Outline, Height, Hover height and Opacity settings. The separate toggleable Show name panel keeps Horizontal offset, Vertical offset, Rotation, Title size and Subtitle size from 1 to 1000 available outside its nested Custom colour toggle, which contains only Text, Text hover and Text active.	PublishedCustom Building styling overrides an enabled Category Building style and then the selected level's Buildings defaults. An enabled Category's Text, Text hover and Text active colours override the level's name colours, while the Building's own Custom colour remains the highest-priority title override. Hover and Active apply to both the flat footprint and 3D body. Size applies in flat and 3D views; flat text has no halo and scales with the Building as the map zoom changes, while the 3D name is attached to the roof and the outline includes the base perimeter.	OffThe Building inherits Category styling when enabled, otherwise its level defaults.
Popup	EditorEnables the Building popup and offers Always stay open. Fields and order are inherited from the shared Popups settings; there is no separate Building content builder.	PublishedSelecting the Building opens only enabled fields that have saved content. In flat mode the popup is centred on the visible footprint; in 3D it stays anchored to the raised roof while the camera zooms, pitches or moves.	OffThe Building has no popup.
ActionPosition	EditorShows move, resize and orange rotation handles for the complete Building without changing its SVG points. Edit changes the shape itself directly on the map.	PublishedThe Building uses its saved per-Building offset, scale and rotation inside the level.	FinishedNo Building positioning handles are shown.
SearchBuilding directory	EditorThe Building list remains synchronized with the selected level, and selecting a result focuses the same Building in the editor sidebar.	PublishedA top-left button opens a searchable fly-in directory grouped by level, with natural case-insensitive name ordering so Building 2 precedes Building 10; selecting an entry changes level, focuses the Building and follows its popup behavior.	HiddenThe visitor directory is hidden when disabled or empty.
URLOpen with a Building selected	EditorUse the Building recordId preserved in the map export as the mapaplace_building query value.	PublishedA published URL ending ?mapaplace_building=building_UUID switches to that Building's level, focuses it and follows its popup behavior after the map loads.	No valid Building IDMissing, duplicate, invalid, hidden, non-interactive or non-matching Building IDs are ignored and the normal saved camera view is used.

Treasure Hunt

The premium Treasure Hunt extension turns ordinary markers and Buildings into QR-scannable stops with browser-local visitor progress, optional automatic anagram letters, found indicators and a completion screen.

Premium - Treasure Hunt module ON

Setting	Editor effect	Published map effect	When empty or off
ActionQR codes and printing	EditorThe QR-code icon in the collapsible Treasure Hunt panel opens QR sizing, an exact scan link for every scannable marker and Building, and a Print all QR codes action. Printed codes use vector SVG output.	PublishedEach QR code opens the published map at its exact marker or Building and adds that place to this browser's hunt progress.	No QR codesThe action is unavailable until Treasure Hunt is enabled and the map contains a scannable place.
Scannable in Treasure Hunt	EditorAppears at the top of each marker and Building settings item. New places are included by default and can be excluded individually.	PublishedIncluded places count towards hunt progress, receive their own QR link and show a centred Bootstrap check after they are found.	OffThe place stays on the map but is excluded from QR printing, progress totals and completion.
TextHunt ID	EditorSets the stable browser-progress identity for this hunt. Keep it unchanged after distributing QR codes.	PublishedSeparates progress for this hunt from other maps and hunts in the same browser.	AutomaticA stable identity is derived from the map when no custom Hunt ID is supplied.
TextAnagram word	EditorEnter an optional word with no more letters than scannable markers and Buildings. Treasure Hunt assigns each letter to a random location and keeps that allocation stable across refreshes. Extra locations award no letter but still count toward completion.	PublishedAfter every location is found, the completion screen shows the collected letters in scan order for the visitor to rearrange into the word.	OptionalIf the word is empty or its letter count does not match the scannable-place count, the hunt works normally without letter tiles.
TextVisitor copy	EditorCustomises the found label, completion title, completion message, action label and optional action URL.	PublishedThe saved labels appear on found places and the completion screen. The removed location-found popup message is not shown.	DefaultsSafe default copy is used for empty fields, and no completion button appears without an action URL.
ProgressVisitor progress	EditorPreview progress mounts in the native top-left MapLibre control stack so it remains clear of the Levels and Buildings controls.	PublishedProgress is stored locally in the visitor's browser, survives page reloads and synchronises between tabs on the same browser.	DisabledDisabling Treasure Hunt removes the progress control without changing marker or Building data.
CompleteTreasure hunt complete	EditorSets the completion heading, message and optional destination action.	PublishedFinding every enabled place closes all marker and Building popups, then shows a completion screen above the map controls, including any automatically assigned anagram letters.	Local progress onlyCompletion links are navigation aids, not access protection. Do not use browser-local progress to protect sensitive content.