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:
At the scheduled time (e.g., once per day), the system checks your XML feed.
It reads the jobs currently inside the feed.
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.
