Progress Map Ultimate exposes shortcodes for the main directory map, lighter single-purpose maps, and module UIs (search forms, nearby, directions, keyword field, submit form).
All shortcodes below are available when Ultimate is active. Module shortcodes also require that module to be enabled under Ultimate Modules.
Quick index
Core (always available)
| Shortcode | Purpose |
|---|---|
lightmap”>[cspm_light_map] |
Lightweight interactive map for selected posts |
streetviewmap”>[cspm_streetview_map] |
Street View for a post / coordinate |
routemap”>[cspm_route_map] |
Map with a route between posts |
advancedsearch”>[cspm_advanced_search] |
Advanced Search |
| Keyword Search | |
| Nearby Places | |
| Directions | |
[cspmsl_form] |
Submit Locations |
List & Filter, Draw a Search, and Markers Filter do not introduce separate shortcodes — they extend [cspm_main_map] via map settings and attributes like list_ext.
How to use shortcodes
- Create and configure the map or form in wp-admin.
- Copy the shortcode from the admin helper (Map Shortcode panel, form list, etc.).
- Paste into a page, post, or block that supports shortcodes.
- In PHP templates:
echo do_shortcode( '[cspm_main_map id="123"]' );Deprecated aliases
Older installs may still contain legacy tags. They keep working but should not be used on new pages:
| Legacy | Use instead |
|---|---|
[codespacing_progress_map] |
[cspm_main_map] |
[codespacing_light_map] |
[cspm_light_map] |
[codespacing_static_map] |
[cspm_static_map] |
[cs_static_marker_map] |
[cspm_contact_map] |
[progress_map_add_location_form] |
[cspm_frontend_form] |
| Attribute | Values | Description |
|---|---|---|
center_at |
lat,lng or post ID |
Override the map center. Decimal degrees only (e.g. 51.510879,-0.117813). A post ID centers on that post’s coordinates. |
post_ids |
1 or 1,2,3 |
Show only these posts. When set, this overrides most Query settings (post type, taxonomies, etc.) for this embed. |
window_resize |
yes / no |
Recenter / adapt when the browser window resizes. Default yes. |
list_ext |
yes / no |
Force List & Filter on/off for this embed, overriding the map’s Activate setting. |
optional_latlng |
true / false |
With List & Filter: include posts that have no coordinates in the list. |
[cspm_main_map id="55" center_at="51.510879,-0.117813"]
[cspm_main_map id="55" center_at="109"]
[cspm_main_map id="55" post_ids="1,2,3,4,5"]
[cspm_main_map id="55" list_ext="yes"]
[cspm_main_map id="55" list_ext="no" window_resize="no"]Notes
- Prefer configuring behaviour in the map admin; use attributes for per-page overrides.
center_atdoes not accept DMS formats (40° 26′ 46″ N …).- See Create & display a map.
[cspm_light_map post_ids="109" height="350px" zoom="14"]
[cspm_static_map post_ids="109" height="250px"]
[cspm_streetview_map post_id="109" height="400px"]
Requires Street View imagery at that point; not every coordinate has coverage. [cspm_contact_map latlng="51.510879,-0.117813" zoom="15" height="320px"]
[cspm_route_map post_ids="10,11,12" travel_mode="WALKING" height="400px"]
For visitor-driven “get directions from my address”, use the Directions module / Submit Locations module).
[cspm_directions_map] instead.
| Attribute | Default | Description |
|---|---|---|
map_id |
frontend_form_map |
Instance id. |
post_id |
— | Target post when editing. |
post_type |
— | Post type context. |
embed |
no |
Embed mode. |
center_at |
— | Initial map center. |
height |
400px |
Map height in the form. |
width |
100% |
Width. |
zoom |
5 |
Zoom. |
map_style |
— | Style override. |
initial_map_style |
from settings | Base map type. |
For public UGC with tabs, uploads, reCAPTCHA, and moderation, prefer [cspmsl_form].
[cspm_advanced_search id="12"]
See Advanced Search. [cspm_keyword_search map_id="55" placeholder="Search listings…"]
The field must point at a real map [cs_nearby_map geoloc="yes" height="500px" layout="pl-mr"]
See Nearby Places. [cspm_directions_map post_ids="109" start_address="London Eye" travel_mode="DRIVING"]
See Directions. ## Module required: Submit Locations.
id. See Keyword Search.
[cspmsl_form] — Submit Locations form
| Attribute | Description |
|---|---|
id |
Form ID (required). |
form_template |
Optional: inline or tabbed. |
[cspmsl_form id="8"]
[cspmsl_form id="8" form_template="tabbed"]See Submit Locations.
Choosing the right shortcode
| Goal | Use |
|---|---|
| Full directory / listings map | [cspm_main_map] |
| Directory with list/grid | [cspm_main_map] + List & Filter (list_ext) |
| One business on Contact page | [cspm_contact_map] |
| Map inside a single listing | [cspm_light_map] / [cspm_static_map] |
| Street View block | [cspm_streetview_map] |
| Fixed itinerary across posts | [cspm_route_map] |
| “Near me” of your listings | [cs_nearby_map] |
| Search landing form | [cspm_advanced_search] |
| Keyword box in the header | [cspm_keyword_search] |
| Public “Add a place” | [cspmsl_form] |
| Get directions UX | Directions on main map or [cspm_directions_map] |
Troubleshooting shortcodes
| Symptom | Check |
|---|---|
Raw [shortcode] text on the page |
Ultimate inactive; builder not processing shortcodes; wrong block type |
| “Map not available!” | Missing/invalid id |
| Module shortcode blank | Module disabled in Ultimate Modules |
| Keyword field missing | map_id not numeric / wrong |
| Styles broken | Cache / minify conflicting with map scripts — see Troubleshooting |