Job Map
The Job Map block displays an interactive map of job locations alongside your job listings. As candidates filter jobs, the map updates in real time to show only the matching pins.
How It Works
Section titled “How It Works”The Job Map block shares the same search state as the Job Listings and Job Filters blocks. When a visitor searches by keyword, filters by category, or selects a job type, the map instantly updates to show only jobs that match - no page reload.
Clicking a pin on the map opens a small popup with the job title and a “View Job” link.
Requirements
Section titled “Requirements”- Jobs must have a Location taxonomy term set (city, region, or full address)
- The location is geocoded automatically when an admin creates the job
- A job with no latitude/longitude is simply left off the map. Existing jobs without coordinates can be backfilled from the Jobs admin.
Adding the Job Map
Section titled “Adding the Job Map”- Open your jobs page in the WordPress editor
- Click + and search for “Job Map”
- Insert the block - recommended placement is beside or below the Job Listings block
Recommended layout:
[ Job Search ] [ Job Filters ][ Job Map ] [ Job Listings ]This two-column layout (Job Map on the left, Job Listings on the right) gives candidates both the spatial and list view simultaneously.
Block Settings
Section titled “Block Settings”In the block sidebar:
| Setting | Default | Description |
|---|---|---|
| Map Height | 480px | Height of the map canvas in pixels |
Map Provider (Geocoding)
Section titled “Map Provider (Geocoding)”WP Career Board Pro supports three geocoding providers. The provider setting controls how a job’s location text is turned into latitude/longitude coordinates. You can set a global default or override it per board.
| Provider | API Key Required | Notes |
|---|---|---|
| OpenStreetMap (Leaflet) | No | Default. Works out of the box. Geocoding via Nominatim. |
| Google Maps | Yes | Requires a Google Maps Platform API key (Geocoding API enabled) |
| Mapbox | Yes | Requires a Mapbox access token |
The on-screen map always renders with Leaflet and OpenStreetMap tiles, regardless of the selected provider. Choosing Google or Mapbox changes only the geocoding service that resolves a location into coordinates - it does not swap the rendered map tiles.
Setting the Global Map Provider
Section titled “Setting the Global Map Provider”- Go to Career Board → Settings → Integrations
- Find the map provider field and choose your provider
- Paste your API key (Google or Mapbox only)
- Click Save
API keys are stored in the wcbp_map_settings option (google_api_key / mapbox_api_key).
Setting a Per-Board Provider
Section titled “Setting a Per-Board Provider”Each board can override the global provider. See Board Settings to configure a different geocoding provider for a specific board.
Geocoding
Section titled “Geocoding”When a job is created, WP Career Board Pro reads the job’s wcb_location taxonomy term(s), geocodes the resulting address with the configured provider, and stores the coordinates as post meta (_wcb_lat, _wcb_lng). This happens automatically - no manual coordinates needed.