Documentation

Geolocation Shortcode Attributes for Jobs and Resumes

Last modified: September 23, 2026

Geolocation modes

WP Job Manager Geolocation extends WP Job Manager’s [jobs] shortcode and, in Pro, Resume Manager’s [resumes] shortcode.

Disabled

Geolocation is disabled when no mode is supplied:

[jobs]

Settings mode

Use the values saved under Geolocation → Search & Map:

[jobs wpjmgeo_mode="settings"]

Shortcode mode

Configure this shortcode instance directly:

[jobs wpjmgeo_mode="shortcode" wpjmgeo_radius="10,25,50" wpjmgeo_units="imperial"]

Older gjm_*, grm_*, and wpjmgeo_use attributes remain available for migration compatibility, but new pages should use the wpjmgeo_* attributes documented here.

Search attributes

wpjmgeo_mode

Controls whether geolocation is disabled or configured from settings or shortcode attributes. Supported values: disabled, settings, shortcode. Default: disabled.

wpjmgeo_element_id

Identifies one search-and-map instance. A random ID is generated automatically. Set it explicitly when coordinating a [jobs] or [resumes] instance with a separately placed results-map shortcode.

wpjmgeo_autocomplete

Enables address suggestions in the search field. Values: 1 or 0. Default: 1.

wpjmgeo_autocomplete_countries

Comma-separated ISO 3166-1 alpha-2 country codes. Example: US,CA,GB. Default: empty.

wpjmgeo_autocomplete_language

Language used for autocomplete. Default: en.

wpjmgeo_locator_button

Displays a visitor-location button in the search field. Values: 1 or 0. Shortcode-mode default: 1.

wpjmgeo_auto_locator

Attempts to detect the visitor’s position on page load. Values: 1 or 0. Shortcode-mode default: 0.

wpjmgeo_radius

One fixed radius or multiple comma-separated choices. Default: 5,10,15,25,50,100.

wpjmgeo_units

Distance units. Values: imperial, metric, or both. Default: both.

wpjmgeo_orderby

One default ordering value or a comma-separated list. Supported values: distance, featured, title, date, modified, ID, parent, rand, and name. Shortcode-mode default: distance,featured,title,date.

wpjmgeo_map

Enables the results map. Values: 1 or 0. Default: 1.

wpjmgeo_map_width

CSS width of the results map. Default: 100%.

wpjmgeo_map_height

CSS height of the results map. Shortcode-mode default: 350px.

wpjmgeo_map_type

Values: ROADMAP, SATELLITE, HYBRID, or TERRAIN. Default: ROADMAP.

wpjmgeo_zoom_level

Zoom used when one marker is displayed. Values: 1 through 20. Default: 12. Multiple-marker maps automatically adjust to fit their markers.

wpjmgeo_max_zoom_level

Optional maximum zoom from 1 through 20. Default: empty/disabled.

wpjmgeo_gesture_handling

Values: none, auto, cooperative, or greedy. Default: auto.

wpjmgeo_marker_clusterer

Groups nearby listing markers. Values: 1 or 0. Default: 1.

wpjmgeo_location_marker_url

URL of the icon used for job or resume markers. Default: empty, which uses the plugin default.

wpjmgeo_visitor_location_marker_url

URL of the visitor-location icon. Default: https://maps.google.com/mapfiles/ms/icons/blue-dot.png.

wpjmgeo_distance

Displays distance beside each qualifying result. Values: 1 or 0. Default: 1.

Search examples

Use the saved Search & Map settings:

[jobs wpjmgeo_mode="settings"]

Create a job directory configured entirely by shortcode:

[jobs wpjmgeo_mode="shortcode" wpjmgeo_autocomplete="1" wpjmgeo_autocomplete_countries="US,CA" wpjmgeo_locator_button="1" wpjmgeo_auto_locator="0" wpjmgeo_radius="10,25,50,100" wpjmgeo_units="both" wpjmgeo_orderby="distance,featured,date" wpjmgeo_map="1" wpjmgeo_map_height="400px" wpjmgeo_zoom_level="12" wpjmgeo_distance="1"]

Use saved resume settings in Pro:

[resumes wpjmgeo_mode="settings"]

Dedicated map and form shortcodes

Jobs — Starter and Pro

  • [wpjmgeo_jobs_geo_form_fields] — outputs geolocation fields for a custom developer-built job search form. It is not needed with the normal [jobs] output. Supply wpjmgeo_mode="settings" or wpjmgeo_mode="shortcode".
  • [wpjmgeo_jobs_results_map] — places the map belonging to a matching job-results instance elsewhere on the page.
  • [wpjmgeo_jobs_single_job_map] — displays one job’s saved location. Use post_id="123" to select a specific job; otherwise the current post is used.
  • [wpjmgeo_jobs_mashup_map] — queries and displays multiple published job locations independently of a results form.

Resumes — Pro

These shortcodes require the Pro package and WP Job Manager Resume Manager:

  • [wpjmgeo_resumes_geo_form_fields]
  • [wpjmgeo_resumes_results_map]
  • [wpjmgeo_resumes_single_resume_map] — use post_id="123" for a specific resume.
  • [wpjmgeo_resumes_mashup_map]

Single-location and mashup map shortcodes accept map attributes such as element_id, map_width, map_height, map_type, zoom_level, gesture_handling, and location_marker_url. See the Mashup Map Shortcode guide for its query-specific attributes.

Using a separately placed results map

An integrated [jobs] or [resumes] instance receives a random element ID automatically. That is sufficient while the map stays with the results.

When the results map is placed with its dedicated shortcode, assign the same explicit ID to both components:

[wpjmgeo_jobs_results_map element_id="jobs-directory"]
[jobs wpjmgeo_mode="settings" wpjmgeo_element_id="jobs-directory"]

For resumes in Pro:

[wpjmgeo_resumes_results_map element_id="resume-directory"]
[resumes wpjmgeo_mode="settings" wpjmgeo_element_id="resume-directory"]

Use a unique ID for every independent listings instance on the page. A results-map shortcode with no matching listings instance has no results payload to display.

menu-circle