Skip to content
English
  • There are no suggestions because the search field is empty.

Troubleshooting failed job board postings

How to read validation errors and warnings, and when to use Retry and Force Post, and what to do when a job disappears from a board.

How to read validation errors and warnings, and when to use Retry and Force Post, and what to do when a job disappears from a board.

Every job you send to a job board gets a posting for each board, and each posting has a status. When a posting fails, the two places to look are the Job Boards page in the left-hand menu (all your jobs together, titled Job Board Postings) and the Job Boards tab on an individual job. Both show the same postings. This article covers reading what went wrong and fixing it. The status meanings are in "Understanding job board posting statuses", and publishing in the first place is in "Publishing a job to job boards".

Who can fix a failed posting

The Job Boards page in the menu is visible to System Admin and HR users only. Retry, Force Post, Unpublish, Re-publish, Retry removal, Post to More Boards and every bulk action are limited to System Admin and HR, on both the page and the job tab. On a job, other internal users can open the Job Boards tab and read the statuses and errors but have no buttons. Users whose only role on the job is Hiring Manager do not see the tab.

Errors that point to Settings > Integrations & Domains > Integrations need a System Admin to fix, because only System Admins can change integration settings.

Reading errors and warnings

On a Failed row on the Job Boards page, click the red errors badge or the amber warnings badge to open Error Details. It shows the job, the board and how many of the 5 retries have been used. On the job's tab the same list sits in the Error column. The list is headed Validation Issues. Each line gives the field name and a plain-language message, with a small badge for where the problem comes from:

  • Content: the job itself, such as the title, description, location or closing date.
  • Config: the integration settings for that board.
  • Board: a rule set by that particular board.

Issues are grouped by where you fix them, and each group has a link: Fix on the job's Edit page, Fix on the job's Application form page, Fix in Publish to Job Boards (board options such as those for S1jobs and JobsGoPublic), Fix in Settings > Integrations, or View the job for details that Recruit fills in itself. Only the first three issues show at first. Use Show more for the rest.

There are two kinds of issue. A red error must be fixed before the posting can go out. An amber warning is something the board might handle badly but does not block delivery, and it can be bypassed with Force Post. Errors are listed above warnings.

Some failures come back from the board after delivery and have no field list. Those show a single error badge and the board's own message as plain text. The messages Recruit itself raises, and what to do about each, are in "Job board validation messages and how to fix them".

Retrying a failed posting

  1. Work out what failed using Error Details, then fix it: edit the job, or ask a System Admin to correct the board's settings.
  2. On the Job Boards page, open the Actions menu (three dots) on the row and choose Retry. On the job's tab, click Retry on the row.

The posting goes back to Pending, its old errors are cleared, and the checks run again. On the Job Boards page a message reads Retry initiated successfully. If it fails again, the new errors replace the old ones.

Retry is only allowed when something has changed since the failure: the job has been edited, or the board's integration settings have been saved. Otherwise the button is greyed out and the tooltip reads Update the job details or the board configuration to fix the issue before retrying.

Each posting can be retried 5 times. On the Job Boards page the count appears under the status (for example 2/5), and Error Details shows it as well. After the fifth, the button reads Max retries reached and Retry stops working for that posting. Contact support if you reach that point and the cause is fixed. If Retry itself is refused you see Failed to retry posting. on the Job Boards page, or Retry failed on the job's tab, with the reason underneath. To retry many failed postings at once, see "Using bulk actions on the Job Boards page".

Force Post

Force Post sends a Failed posting to the board without stopping for its warnings. It is available only when every listed issue is a warning. If even one error is present, Force Post is greyed out with the tooltip Fix hard validation errors before force-posting.

On the job's Job Boards tab, click Force Post on the row. The Force Post Despite Warnings box lists the warnings that will be bypassed and says the posting may not appear optimally on the job board. Click Force Post Anyway, or Cancel to stop. On the Job Boards page, Force Post is in the row's Actions menu and submits straight away, with no list of warnings first. If you want to read them before overriding, use the job's tab.

Once the posting has been delivered, an Overridden badge stays on the row on the job's tab. Its tooltip gives the number of warnings and who overrode them and when.

For Adzuna and LinkedIn Limited, all organisations share one board file that Recruit rebuilds regularly. While a rebuild is running, and for 30 minutes after it finishes, Force Post is greyed out on the job's tab. The tooltip reads Feed rebuild in progress during the rebuild, and afterwards names the time Force Post becomes available.

When a job disappears from a board

  1. Open the job's Job Boards tab and read the status. Unpublished or Expired explains it. Check what happened to the job. Closing or archiving a job withdraws all its board postings. Pausing a job withdraws them too, except the careers page when you chose to keep taking applications. Un-pausing puts the careers page back but not the other boards, and reopening a closed job does the same unless you choose boards in the reopen box. A job also closes when its closing date passes. Send the job to the other boards again with Post to More Boards or Re-publish, as described in "Changing, unpublishing and bulk publishing postings".
  2. If the status is Posted, Published or Sent, use Check Status on that row. Job not found on board means the board itself no longer lists it.
  3. If it is Failed, use the earlier sections to fix it and retry.

If a check keeps returning credential errors, or a posting has used all 5 retries with the cause fixed, contact support.

Related articles