Job Feed - Overview

You can publish your live jobs as an XML feed and give the address to job aggregators, so they list your jobs and keep them up to date.

Turn the feed on

1. Go to Career Board → Settings → Job Feed.
2. Turn on Enable Feed.
3. Optional: enter a Contact Email. It goes in the <email> field of every job. Leave it empty to publish no address. The field is empty by default, and your WordPress admin email is never published for you.
4. Save. The Feed URL row shows the address, with View Feed and Copy URL buttons. If the browser blocks copying, for example on a site without HTTPS, the button says to press Ctrl+C instead.

The feed address is:

https://yoursite.com/wcb-jobs.xml

Submit that address to any aggregator that accepts an Indeed-style XML feed. The feed is off by default.

To turn it off, switch Enable Feed off. The address then returns your theme’s 404 page with an HTTP 404 status, and aggregators stop receiving your jobs.

What the feed contains

The feed has one <source> element that holds <publisher> (your site title) and <publisherurl> (your home address), followed by one <job> for each published job, newest first. A job whose application deadline has passed is left out. A job with no deadline stays in, and a job whose deadline is today stays in until the day ends.

Each <job> has:

Field	Value
<title>	Job title
<date>	Publication date, in RFC-822 form, GMT
<referencenumber>	The job’s post ID
<url>	The job’s public address
<company>	Company name
<city>	The city of the job’s first location, as in the job’s Google structured data. Empty when the job has no location.
<country>	The country of that location. Empty when the job has none.
<remotetype>	Fully remote. Present only on jobs marked remote.
<description>	The job description as plain text, with HTML removed
<salary>	Salary range with the job’s own currency symbol, for example $80,000 - $120,000 / yearly. Empty when the job has no salary.
<jobtype>	The job’s first job type
<email>	The Contact Email from the settings. Left out of every job when the setting is empty.
<expirationdate>	The job’s application deadline. Empty when the job has none.

More than 200 jobs

Each feed page holds up to 200 jobs. Add a start parameter to read further pages:

https://yoursite.com/wcb-jobs.xml?start=0     jobs 1 to 200
https://yoursite.com/wcb-jobs.xml?start=200   jobs 201 to 400
https://yoursite.com/wcb-jobs.xml?start=400   jobs 401 to 600

Caching

Each feed page is cached for one hour, and the response tells CDNs and aggregators they may cache it for one hour too. When any job is saved, the next request builds a fresh feed, so you never need to clear anything by hand. A job that passes its deadline without being saved drops out of the feed when the cached page is rebuilt, within the hour.