Documentation

Geo Form Fields Shortcode

Last modified: September 22, 2026

Purpose

The Geo Form Fields shortcode outputs the location, radius, units, ordering, and supporting hidden values needed by a custom WP Job Manager search form.

It outputs only the geolocation controls. It does not create the surrounding HTML form, keyword or category fields, a submit button, the results loop, or a map.

When to use it

Use this shortcode when a theme or custom template builds its own Jobs or Resumes search form instead of displaying the standard [jobs] or [resumes] filter form.

Do not add it beside the normal filter form produced by [jobs] or [resumes]. Those shortcodes already receive the geolocation fields when wpjmgeo_mode is enabled.

Jobs shortcode

Use the saved Search & Map settings:

[wpjmgeo_jobs_geo_form_fields wpjmgeo_mode="settings"]

Configure the geolocation controls directly:

[wpjmgeo_jobs_geo_form_fields wpjmgeo_mode="shortcode" wpjmgeo_autocomplete="1" wpjmgeo_locator_button="1" wpjmgeo_radius="10,25,50" wpjmgeo_units="both" wpjmgeo_orderby="distance,date"]

Resumes shortcode

The Resume shortcode requires WP Job Manager Geolocation Pro and the separate WP Job Manager Resume Manager extension:

[wpjmgeo_resumes_geo_form_fields wpjmgeo_mode="settings"]

Shortcode mode is also available:

[wpjmgeo_resumes_geo_form_fields wpjmgeo_mode="shortcode" wpjmgeo_radius="25,50,100" wpjmgeo_units="imperial"]

Settings and shortcode modes

  • wpjmgeo_mode="settings" uses the values saved in the corresponding Jobs or Resumes Search & Map settings.
  • wpjmgeo_mode="shortcode" uses the geolocation attributes supplied on this shortcode.
  • wpjmgeo_mode="disabled" produces no Jobs geolocation fields and should not be used for an active custom geolocation form.

The supported search attributes—including autocomplete countries, radius, units, ordering, locator controls, and map settings—are listed in Geolocation Shortcode Attributes.

Custom form responsibilities

The developer or theme building the custom form must still provide:

  • A valid opening and closing <form> element.
  • The correct destination for the Jobs or Resumes results page.
  • Any keyword, category, type, or other non-geolocation controls.
  • A submit button.
  • A compatible results/listings instance that reads the submitted WP Job Manager filters.

If a Results Map is placed separately, the custom form/results workflow and the map must also use a coordinated element ID. See Results Map Shortcode.

Developer feature: This shortcode supplies WP Job Manager Geolocation’s form controls; it does not turn arbitrary HTML into a complete AJAX listings application.

Troubleshooting

  • No fields appear: confirm that a non-disabled wpjmgeo_mode is supplied and that the correct Starter/Pro module is active.
  • Autocomplete does not work: verify the Browser API Key, Places API (New), website restrictions, and the front-end console.
  • The form submits but results ignore location: verify that the destination page uses a compatible Jobs or Resumes results instance and preserves the submitted geolocation values.
  • Duplicate location controls appear: remove the Geo Form Fields shortcode when the standard [jobs] or [resumes] filter form already supplies them.

For general failures, see Maps, Autocomplete, and Search Troubleshooting.

menu-circle