Documentation

Mashup Map Shortcode

Last modified: September 22, 2026

Introduction

The Mashup Map shortcode displays multiple geocoded job listings or resumes as markers on one map. It runs its own listing query, so it is useful for a standalone map that is not tied to a WP Job Manager results list.

The map can limit how many locations are loaded, filter locations by state or country, hide filled jobs, cluster nearby markers, and use a custom marker icon.

Mashup map displaying multiple job locations
A mashup map displaying multiple geocoded listings.

Available Shortcodes

Job Listings

[wpjmgeo_jobs_mashup_map]

The jobs shortcode is included with the Starter and Pro packages.

Resumes

[wpjmgeo_resumes_mashup_map]

The resumes shortcode is included with Pro and requires the separate WP Job Manager Resume Manager extension.

Shortcode Attributes

Add attributes inside the shortcode tag, separated by spaces. For example:

[wpjmgeo_jobs_mashup_map map_height="500px" max_locations="100" marker_clusterer="1"]

1. element_id

Assign a specific identifier to this map instance. If omitted, the plugin generates a unique ID automatically.

Supported values: A unique ID string

Default: Automatically generated

Example: element_id="regional-jobs-map"

2. map_width

Set the width of the map container.

Supported values: A CSS width such as 100% or 800px

Default: 100%

3. map_height

Set the height of the map container.

Supported values: A CSS height such as 400px or 50vh

Default: 400px

4. map_type

Select the map style.

Supported values: ROADMAP, SATELLITE, HYBRID, or TERRAIN

Default: ROADMAP

5. zoom_level

Set the initial zoom level. When the map contains multiple markers, it can adjust the view to fit the available locations.

Supported values: An integer from 1 to 20

Default: 12

6. max_locations

Limit the maximum number of published listings retrieved for the map. The newest matching listings are queried first.

Supported values: A positive integer

Default: 200

7. show_filled_jobs

Include job listings marked as filled. This attribute applies only to the jobs shortcode.

Supported values: 1 to include filled jobs or 0 to hide them

Default: 0

8. search_state

Display only locations whose indexed state or region matches the supplied value.

Supported values: A state or region name or code, such as Florida or FL

Default: Empty

9. search_country

Display only locations whose indexed country matches the supplied value.

Supported values: A country name or code, such as United States or US

Default: Empty

10. marker_clusterer

Group nearby markers into clusters.

Supported values: 1 to enable or 0 to disable

Default: 1

11. location_marker_url

Use a custom image for every listing marker on this map.

Supported values: A complete image URL

Default: Empty, which uses the default location marker

12. gesture_handling

Control how the map responds to scroll, touch, and trackpad gestures.

Supported values: auto, cooperative, greedy, or none

Default: auto

Examples

Display the latest geocoded job listings:

[wpjmgeo_jobs_mashup_map]

Display up to 100 job locations on a taller satellite map:

[wpjmgeo_jobs_mashup_map max_locations="100" map_height="500px" map_type="SATELLITE"]

Display non-filled jobs indexed in Florida:

[wpjmgeo_jobs_mashup_map show_filled_jobs="0" search_state="FL"]

Display resumes indexed in the United States without marker clustering:

[wpjmgeo_resumes_mashup_map search_country="US" marker_clusterer="0"]

Use a custom job marker:

[wpjmgeo_jobs_mashup_map location_marker_url="https://example.com/images/job-marker.png"]

Troubleshooting

  • No markers appear: Confirm that published listings have indexed locations. Use Location Tools: Migration and Repair if locations are missing.
  • The map does not load: Verify the Browser API key and its required services and restrictions in Generating Google Maps API Keys.
  • A boundary filter returns no matches: Check the state and country values stored with the locations and use the same names or codes in the shortcode.
  • Too many markers affect performance: Lower max_locations and keep marker_clusterer="1".

The Mashup Map is a standalone listing map. To keep a map synchronized with the results returned by a WP Job Manager search form, use the geolocation-enabled [jobs] or [resumes] search workflow and the related results-map shortcode instead.

Review Search & Map Settings or review the geolocation shortcode attributes.

menu-circle