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

Collecting referee details from a candidate

Get a candidate's referees onto their References tab, by application form, by asking the candidate to nominate them, or by adding them yourself.

Get a candidate's referees onto their References tab, by application form, by asking the candidate to nominate them, or by adding them yourself.

This is for System Admins and HR users. A reference starts with the referee's contact details. Members, Agency users, hiring managers and interviewers who open the References tab see only a message that references are managed by administrators and HR, and cannot add or edit referees. Referees never need a Recruit account.

Referees belong to an application

A candidate can have several applications, and the profile shows one at a time. Referees, nominations and reference requests all belong to the application selected at the top of the profile. The References tab lists only that application's referees, and says "No referees for this application yet." when there are none. To work on another job, use Switch application first.

On an Incomplete application, one the candidate has started but not submitted, you can add referees and ask the candidate to nominate them. A reference request cannot be sent until the application is submitted.

From the application form

If your application form has a References section, the referees a candidate enters are copied onto the References tab when they submit. No email goes to those referees at this point. You still have to request the reference yourself.

Ask the candidate to nominate referees

  1. Open the candidate's profile, switch to the right application if they have more than one, and go to the References tab.
  2. Select Request Referees. The Ask for Referees window opens.
  3. Pick a Template for the email, and choose the Referee form the candidate will complete. If you choose neither, the defaults are used.
  4. Edit the Subject and Message. The message must keep the merge field, or Send Request stays disabled. and are also available. Selecting a field in the Merge fields picker inserts it where your cursor is.
  5. Select Send Request.

The email goes to the candidate's email address and is recorded on their timeline. If the candidate has no valid email address, the request is recorded but no email is sent.

If the chosen referee form has no name field and no email field, Recruit refuses with "This referee form needs a name field and an email field before a link can be sent. Add them in the form template, or choose another form." Fix the form as described in "Building referee and reference forms", or choose another one.

What the candidate sees

The link opens a page headed "Nominate your referees". The candidate can enter up to 10 referees, then select Submit referees. If a required field is empty or an answer is not valid, the page shows "Please correct the highlighted fields for every referee." and marks each field that needs attention, for example "This field is required." Questions whose conditions do not apply are hidden and not required.

The link works once. After a submission it shows a thank-you message instead of the form, so the candidate cannot add more through the same link. Each nominated referee then appears on the References tab for that application, but no reference has been requested yet.

If something goes wrong when the candidate submits, the page tells them:

  • "We couldn't save your referees. Please refresh the page, check each referee's name and email, and try again. If it still doesn't work, contact the recruiter who emailed you."
  • "Your referees have already been sent to the recruitment team, so there is nothing more to do."
  • "Too many attempts. Please wait a minute and try again."
  • "Something went wrong and your referees have not been saved. Please try again in a few minutes, or contact the recruiter who emailed you."

A link that has expired or been withdrawn shows "This link is no longer valid".

Add or edit a referee yourself

  1. On the References tab, select Add Referee.
  2. Enter Name and Email. Both are required. Name and company can each be up to 200 characters, email up to 320.
  3. Optionally enter Company.
  4. Under Contactable, choose Not recorded, Yes, may be contacted or No, do not contact. Not recorded is the default.
  5. Select Add Referee.

To fix a typo later, expand the referee and select Edit. You can change the name, email and contactable answer. Changing the email address cancels any request that is still waiting, because the link already sent went to the old address. The card then shows a Cancelled badge and you need to send the request again.

Problems

  • The referee you expect is missing. Referees are listed per application. Check which application is selected.
  • Cannot delete referee with an active reference request. Complete the request with Mark Received, or change the referee's email address to cancel it, then delete. Deleting a referee also deletes all of their reference requests.
  • Send Request stays disabled. The message is missing , or the subject or message is empty.