XML Imports

With JobBoard.io you can import jobs from 3rd party XML job feeds without any code. JobBoard.io can pull job content from third party XML feeds and automatically post them to your job board on a daily schedule.

The Auto Import Jobs feature allows you to map feed specific XML tags to the correct fields on your job board. This means JobBoard.io works with virtually any XML job source, without a need to follow any preset naming conventions.

🚧

RSS Feed?

Please note that RSS is different to XML.

RSS feeds will not usually contain enough data to create a job listing.

Feed setup is broken up into two sections. The first section is where you'll set up the basic info for the feed. The second allows you to map custom field names. To begin the process of creating a feed, click Job Settings in the left sidebar, choose Auto Import, then click Create New Feed.

Basic Feed Setup

676676
  • Name - Name your feed. Use a descriptive name that will help you identify the feed in the future.
  • URL - Enter the URL where the feed can be accessed. Entering this URL in your browser should display the job data in the feed.
  • Frequency - Choose how often jobs from the feed are imported; Daily, Weekly, or Monthly.
  • Process Updates - If this box is checked, existing jobs will be updated according to changes in the feed.
  • Auto Expire Jobs - If this box is checked, jobs that drop out of the feed will be automatically expired the next time the feed is processed.
  • Format - At this time only XML is available. If you have a different format you'd like to use, please contact [email protected] and we'll be happy to review.
  • Feed Locale - Specify the Language used by the originating website. We'll use this to determine the date format in the feed.
  • Status - Set the feed to Running or Paused. Pausing will allow you to temporarily disable a feed without having to delete it. Pausing the feed will do so indefinitely, so you'll need to manually set it back to 'Running' when you're ready to import jobs again.
  • Auto Publish Jobs - Select "Yes" to have your jobs automatically publish to your site. If you'd like to review and manually publish jobs that come through the feed, select 'No'. With 'No' selected, jobs will be created as a draft.
  • Employer - Automatically assign all jobs in the feed to a specific Employer Account.
  • Location - If desired, set a backup location for jobs in the feed. If a job comes through with no location specified, this Location will be used.

📘

Set up Filters

After setting up your feed, you'll have the option to create filters. Find out more!

Custom Field Setup

Once you have the basic information entered for your feed, you'll want to make sure that the fields in your feed map correctly to the fields in JobBoard.io. The grey letters display the default XML tag we'll look for when importing XML feeds.

752752

By default, we'll expect the Company URL to be passed as follows:

<company_url>https://www.jobboard.io/</company_url>

In the example screenshot above, you'll see that we've entered a value of 'website' for Company URL. This lets the system know to look for the Company URL in the feed as such:

<website>https://www.jobboard.io/\</website>

Mapping out custom fields is that easy! If you aren't comfortable examining your partner feeds for tag names, we recommend asking your partners to provide a list when you get their feed URL. Many providers will already have this information documented.

After the form is complete, click Save.

Available Fields

Below, we'll cover each field available to be imported via XML imports.

JobBoard.io FieldPurposeDefault XML tagRequired?
RootGroups information for each jobjobYes
TitleThe title of the jobtitleYes
CompanyThe hiring companycompanyYes
Company URLA link to the company websitecompany_urlNo
LocationThe complete job locationlocationYes, or city and state
RemoteIs the job remote? True or FalseremoteNo
CityThe City where the job is locatedcityYes, or location
StateThe State where the job is located. For non-US jobs, you may map the country field herestateYes, or location
ZipThe Zip or Postal code where the job is locatedzipNo
CountryThe Country where the job is locatedcountryNo
DescriptionThe job descriptiondescriptionYes
Apply URLIf the application form is hosted elsewhere, add the link here.urlYes, or Apply Email
Apply EmailWhere should applications be sent to?emailYes, or Apply URL
CategoryThe category for the job.categoryNo
Reference IDSet the unique reference ID for the jobreferenceNo
LogoLink to the employer logologoNo
SalaryWhat is the salary for this job?salaryNo
Posting DateSet a posting date for the job. If left blank, we'll use the time the job is created in our system. Required format is: MM/DD/YYYYNo default, must be populatedNo
Job TypeIs this position Full Time? Part Time? Be sure the value used matches a job type that's been set up under 'Job Types' in your admin panel. If no type is provided, the default job type will be used.jobtypeNo
Expiration DateSet the expiration date. If no date is provided, we will use the default posting length for you site. Required format is: MM/DD/YYYYNo default, must be populatedNo

Feed Preview

After setting up your feed, we highly recommend using the Preview to verify that the information in the feed is mapping out as expected. To Preview your feed:

  1. Click Auto Import Jobs in the left hand navigation menu.
  2. Locate the feed you'd like to Preview, and click the corresponding Edit button.
  3. Click the Preview button above the form.

Be sure that the fields listed above as required have been populated. If required data is missing in the preview, follow our troubleshooting guide.

Troubleshooting Feeds

Required Fields Missing in Preview

  1. Copy the Feed URL, and paste into a new browser window. If your feed is in XML format, you'll see something that looks like the below example:
<jobs>
  
  <job>   <!-- This is the 'Root' and identifies a new job -->
  <job_title>Generator Service Engineer</job_title> <!-- Job Title -->
  <description>
  This highly respected international engineering company has had a long established presence. With over 15 years in the region they have developed an unrivalled reputation for delivery and service to their clients. Regarded by many as leaders in the power generation market they cover the spectrum of heavy industrial to medical to entertainment, as a result they can offer a unique and varied working environment.
  </description> <!-- Description is displayed within the job post -->
  <url>http://www.samplecompany.com/apply</url>  <!-- Link for the Apply Button -->
  <apply_email>[email protected]</apply_email> <!-- Email address for Apply Form.  Either a url or apply_email will be required -->
  <company>Compu-Global-Hyper-Mega-Net</company>
  <company_url>http://www.samplecompany.com<company_url>
  <city>San Francisco</city>
  <location>USA</location>
  <state>CA</state>
  <reference>12345</reference>
  </job>

  <job>   <!-- This is the 'Root' and identifies a new job -->
  <job_title>Customer Service Guru</job_title> <!-- Job Title -->
  <description>
  Build a career without boundaries. Do work that matters, with the flexibility to pursue your passion wherever it leads. Bring your ambition to make a difference. We’ll bring a world of opportunities.
  </description> <!-- Description is displayed within the job post -->
  <url>http://www.samplecompany.com/apply</url>  <!-- Link for the Apply Button -->
  <apply_email>[email protected]</apply_email> <!-- Email address for Apply Form.  Either a url or apply_email will be required -->
  <company>Compu-Global-Hyper-Mega-Net</company>
  <company_url>http://www.samplecompany.com<company_url>
  <city>San Francisco</city>
  <location>USA</location>
  <state>CA</state>
  <reference>12345</reference>
  </job>
  
</jobs>
  1. Identify the missing information in the feed. For this example, lets say that the Job Title was not present in the Preview.
  2. Look for the Job Title and the XML tag surrounding it. In this example, you'll find <job_title>Generator Service Engineer</job_title>
  3. We already know that the system expects <title> by default, but this feed uses <job_title>. We'll need to update this in the Custom Fields.
  4. Back on the Auto Import Jobs screen, click the Edit button to open the feed setup.
  5. Scroll down to Custom Fields, and enter job_title in the Title field.
  6. Click Save and check the Preview. Continue these updates until all required fields are populated.

No Jobs Detected

If no jobs are detected in the feed, follow the steps above to check the Root. This is what separates the jobs from each other. In the example XML, the Root is <job>.

XML feed exceeds the limit

Contact our Support team! We'll review the feed and will, in most cases, increase in the limit to accommodate.

Feed is unreachable

In most cases, you'll need to contact the feed provider to have any accessibility issues addressed.

Still not working?

If everything looks good but jobs still aren't importing, check the Log. This can give you insight into data issues that might prevent jobs from importing as expected. The log will be updated daily with the results of the most recent import.

932932

👍

Need help?

Having issues mapping your jobs? Unsure of how to correct an issue you see the logs? Contact our support team using the chat icon in the bottom right corner of your admin panel, or by e-mailing [email protected] We're always happy to help!