Documentation

Resume Geolocation Setup and Migration

Last modified: September 22, 2026

Requirements

Resume geolocation is included in WP Job Manager Geolocation Pro. It requires the separately installed WP Job Manager Resume Manager extension version 2.0 or newer.

Pro provides the integration; it does not include Resume Manager itself. The Starter package does not contain the Resume components.

Before upgrading

  1. Create complete database and file backups.
  2. Rehearse the upgrade on a staging copy.
  3. Record the existing Resume Manager Geolocation settings, shortcodes, resume search page, and a few known resume locations.
  4. Confirm that the Browser and Server API keys are configured as described in Generating Google Maps API Keys.

If the standalone Resume Manager Geolocation extension is active, leave it installed until the Pro package and migrated Resume data have been verified.

Install and activate Pro

  1. Install the stable WP Job Manager Geolocation Pro package when it is offered in your account or WordPress updater.
  2. Open Job Listings → Settings → Geolocation → License.
  3. Connect the WPGeo account or activate a license compatible with Pro.
  4. Confirm that Resumes → Settings → Geolocation is available.

A Pro license does not add Pro files to a Starter installation. If the Resume settings are missing, confirm that the installed package itself is Pro and that Resume Manager is active.

Migrate settings and locations

Version 3.0 automatically converts legacy Resume Manager Geolocation settings from the grm option namespace into the current Pro Resume settings. Existing 3.0 values take precedence, and the legacy options remain untouched.

The one-time places_locator migration processes Job and Resume location rows together:

  1. Go to Job Listings → Settings → Geolocation → Tools.
  2. Find Location Upgrade.
  3. Click Finish / Resume Migration when migration is not yet complete.
  4. Keep the page open until the progress panel reports completion and the migration notice disappears.

The migration copies legacy location data in bounded, retry-safe batches and leaves the legacy table unchanged. It can retain rows even when a related post no longer exists.

If current Resume posts still lack indexed locations after the versioned migration completes, go to Resumes → Settings → Geolocation → Tools and run Scan for Missing Resume Locations. The repair scanner does not overwrite an existing WPGeo location. Enable optional geocoding only when necessary because it can consume Google quota and incur charges.

See Location Tools: Migration and Repair for the distinction between the migration and repair workflows.

Configure Resume geolocation

Resume settings are stored separately from Job settings:

  • Resumes → Settings → Geolocation → General controls administrator and front-end Resume address autocomplete and country restrictions.
  • Search & Map controls Resume proximity search, radius, units, ordering, results map, markers, and distance display.
  • Single Resume Page controls the automatic map on individual Resume pages.
  • Tools scans current Resume posts for missing indexed locations.

The Browser API Key, Server API Key, Google country and language, License tab, and one-time Location Upgrade runner remain under the Job Listings settings because they apply to the whole plugin installation.

Use the saved Resume search settings with:

[resumes wpjmgeo_mode="settings"]

For a page-specific configuration, use wpjmgeo_mode="shortcode" and the attributes in Geolocation Shortcode Attributes for Jobs and Resumes.

Verify the Resume workflow

  1. Create or update a test Resume and select a new address from autocomplete.
  2. Confirm that the Resume can be found with a known proximity search.
  3. Verify its distance, results-map marker, and Single Resume Page map.
  4. Test the same search with the results map disabled; proximity filtering does not require a visible map.
  5. If a separately placed results-map shortcode is used, confirm it shares the same explicit element ID as the [resumes] instance.
  6. Clear page, object, host, and CDN caches and repeat the public test while logged out.

Remove the standalone extension

After the Pro Resume workflow and migrated data have been verified:

  1. Deactivate the standalone Resume Manager Geolocation extension.
  2. Repeat the Resume submission, search, results-map, and single-map checks.
  3. Remove the deprecated extension only after the site still passes those checks.

WP Job Manager Geolocation displays an administrator notice while the deprecated standalone extension remains active. If rollback is required, restore the complete pre-upgrade database and matching plugin files together.

Related guides

menu-circle