Skip to main content

XML Import – Full Guide

The XML Import feature allows you to automatically import jobs from an external XML feed into your Job Boardly board.

Joaquin Cahiza avatar
Written by Joaquin Cahiza
Updated over a week ago

What Is XML Import?

The XML Import feature allows you to automatically import jobs from an external XML feed into your Job Boardly board.

Instead of posting jobs manually, you:

  • Paste the XML feed URL

  • Choose how often it should refresh

  • Map feed fields (title, description, etc.)

  • Let the system update jobs automatically


How XML Updates Work (Very Important)

Job Boardly does not maintain a live sync with your website.

It works like this:

  1. At the scheduled time (e.g., once per day), the system checks your XML feed.

  2. It reads the jobs currently inside the feed.

  3. It creates new jobs, updates existing ones, or removes them (if configured).

Important:

  • If a job is updated inside the XML → it updates on your board at the next scheduled import.

  • If a new job appears in the XML → it gets added at the next import.

  • If a job disappears from the XML → it will only be removed if you enabled automatic removal.

  • If the XML feed does not update → your board will not update.

Job Boardly reads the XML feed — not the original website.


Step-by-Step Setup

1. URL

Paste the XML feed URL (must be a valid XML feed, not a normal webpage).


2. How many jobs should we import?

Set a limit per import.
Leave blank for no limit.


3. How often should we import jobs?

Choose how frequently the system checks the feed (e.g., once per day).


4. Expire after (days)

Set how many days jobs remain published.
Leave blank to use your board’s default expiry.


5. Use expiry from source (toggle)

If the feed provides an expiration date, enabling this will use it.


6. What status should these jobs have?

Choose whether jobs are published immediately or saved as draft.


7. Automatically remove jobs when they disappear from the feed (toggle)

If enabled, jobs will be removed when they no longer appear in the feed.


8. Mirror the feed (toggle)

Keeps jobs live until they are removed from the feed (no auto-expiry).


Field Mapping (Critical Step)

This is where you connect XML fields to Job Boardly fields.

Job Title

Select the field that contains the job title.

Job Type

Map feed values to your board’s job types.
You can set a fallback if none is provided.

Job Category (optional)

Map feed categories to your board categories.

Description

Select the field that contains the job description.

Company Name

Select the field for the employer name.

Company URL (optional)

Map if available.

Application Link

Select the URL where candidates apply.

Publish Date (optional)

Use if your feed includes publish dates.


Location Settings

Location Type

Map Remote / Hybrid / Onsite values.
Set a fallback if needed.

Location / Country / Region / City

Use structured fields if your feed provides them.


Salary (Optional)

If your feed includes salary data:

  • Set salary currency

  • Map minimum and maximum salary

  • Choose salary schedule (hourly, yearly, etc.)

Salary requires both currency and schedule to work properly.


Common Issues

Jobs are not updating

  • Check if the XML feed itself updated.

  • Confirm the import schedule.

  • Remember: we read the XML, not the website.


Old jobs are still visible

  • Auto-remove may be disabled.

  • Expiry period may be long.

  • Mirror mode may be enabled.


New jobs are not appearing

  • Check if you set a job limit.

  • Confirm the feed contains the new jobs.

  • Wait for the next scheduled import.


Jobs appear duplicated

This may happen if:

  • The feed changes job IDs.

  • The importer was recreated instead of updated.

Did this answer your question?