Introduction
WP Job Manager Geolocation extends the default [jobs] and [resumes] shortcodes with powerful location-based features such as proximity search, interactive maps, address autocomplete, and distance display.
Geolocation is disabled by default and must be explicitly enabled using the wpjmgeo_mode shortcode attribute.
This page explains how to enable and control geolocation behavior using shortcode attributes and when each mode is appropriate.
Geolocation Modes
The primary attribute that controls geolocation behavior is wpjmgeo_mode.
1. Disabled (default)
When no mode is specified, geolocation features are disabled. No location search, maps, or distance calculations will run.
Example: [jobs]
2. Settings Mode (Recommended)
Use the plugin’s Search & Map settings pages to control all geolocation behavior.
Dashboard → Job Listings (or Resumes) → Settings → Geolocation → Search & Map
Example: [jobs wpjmgeo_mode="settings"]
This mode is ideal when you want to manage geolocation behavior globally from a single settings page.
3. Shortcode Mode
Ignore all plugin settings and control geolocation behavior entirely using shortcode attributes.
Example: [jobs wpjmgeo_mode="shortcode"]
This mode is useful when you need different geolocation behavior per page or per shortcode instance.
Shortcode Attributes
All attributes below apply to both job listings and resumes, unless noted otherwise.
1. wpjmgeo_mode
Controls whether geolocation is enabled and how it is configured.
Available values: settings, shortcode
Default: disabled
2. wpjmgeo_element_id
Sets a unique element ID for the geolocation instance. This value is automatically generated and rarely needs to be set manually.
Default: Auto-generated
3. wpjmgeo_autocomplete
Enable Google Places autocomplete in the location search field.
Supported values: 1 (enabled), 0 (disabled)
Default: 1
4. wpjmgeo_autocomplete_countries
Restrict Google Places autocomplete suggestions to one or more specific countries. Countries must be provided as ISO 3166-1 alpha-2 country codes, separated by commas.
Supported values: Comma-separated country codes (e.g. US,CA,GB)
Default: Empty (all countries allowed)
5. wpjmgeo_autocomplete_countries
Restrict Google Places autocomplete suggestions to one or more specific countries. Countries must be provided as ISO 3166-1 alpha-2 country codes, separated by commas.
Supported values: Comma-separated country codes (e.g. US,CA,GB)
Default: Empty (all countries allowed)
6. wpjmgeo_autocomplete_language
Set the language used for autocomplete results.
Default: en
wpjmgeo_locator_button
Display a locator button inside the location field that allows visitors to detect their current location.
Supported values: 1 (enabled), 0 (disabled)
Default: 1
7. wpjmgeo_auto_locator
Automatically detect the visitor’s location on page load and immediately apply the search. This option should be used carefully, as it may trigger browser permission prompts.
Supported values: 1 (enabled), 0 (disabled)
Default: 0
8. wpjmgeo_radius
Define the search radius used for proximity filtering. A single value sets a fixed radius. Multiple comma-separated values will display a dropdown selector.
Supported values: A number or comma-separated numbers
Default: 5,10,15,25,50,100
9. wpjmgeo_units
Define the distance unit system used for radius and distance calculations.
Supported values:
imperial – Milesmetric – Kilometersboth – User selectable
Default: both
10. wpjmgeo_orderby
Define how results can be ordered in the search form.
Supported values: distance, featured, title, date, modified, ID, parent, rand, name.
Default: distance,featured,title,date
11. wpjmgeo_map
Enable or disable the Google Map display above or below the results list.
Supported values: 1 (enabled), 0 (disabled)
Default: 1
12. wpjmgeo_map_width
Set the width of the map container.
Supported values: CSS width values (e.g. 100%, 600px)
Default: 100%
13. wpjmgeo_map_height
Set the height of the map container.
Supported values: CSS height values (e.g. 350px, 50vh)
Default: 350px
14. wpjmgeo_map_type
Define the visual map type used for rendering results.
Supported values:
ROADMAPSATELLITEHYBRIDTERRAIN
Default: ROADMAP
15. wpjmgeo_zoom_level
Controls the initial zoom level of the map.
When set to auto, the map automatically adjusts to fit all visible markers.
Supported values: auto or a number between 1 and 20
Default: auto
16. wpjmgeo_max_zoom_level
Limits how far users can zoom into the map. This is useful when using auto zoom to prevent excessive zooming on closely grouped markers.
Supported values: A number between 1 and 20, or empty to disable
Default: Disabled
17. wpjmgeo_gesture_handling
Controls how users interact with the map using mouse, trackpad, or touch gestures.
Supported values:
auto – Default Google Maps behaviorgreedy – Always capture scroll and touch gesturescooperative – Require modifier keys for zoomingnone – Disable map gestures entirely
Default: auto
18.wpjmgeo_marker_clusterer
Enable clustering of nearby map markers to improve readability and performance.
Supported values: 1 (enabled), 0 (disabled)
Default: 1
19.wpjmgeo_location_marker_url
wpjmgeo_location_marker_url
Custom icon URL used for job or resume location markers on the map.
Supported values: Valid image URL
Default: Plugin default marker
20.wpjmgeo_visitor_location_marker_url
Custom icon URL used for the visitor’s detected location marker.
Supported values: Valid image URL
Default: Google Maps blue dot
21.wpjmgeo_distance
Display the calculated distance next to each result in the listings output.
Supported values: 1 (enabled), 0 (disabled)
Default: 1
Shortcode Examples
Use global settings
[jobs wpjmgeo_mode="settings"]
Fully controlled via shortcode
[jobs wpjmgeo_mode="shortcode" wpjmgeo_radius="10,25,50,100" wpjmgeo_units="imperial" wpjmgeo_autocomplete="1" wpjmgeo_locator_button="1" wpjmgeo_map="1" wpjmgeo_zoom_level="12" wpjmgeo_distance="1"]
Resume search with geolocation
[resumes wpjmgeo_mode="settings"]
Helpful Links