Right to work and governance
How to record a candidate's right to work check on the Governance tab, and what the offer stage does when it is not verified.
How to record a candidate's right to work check on the Governance tab, and what the offer stage does when it is not verified.
Right to work is recorded on the Governance tab of a candidate's profile. You set a status, log the documents you saw, keep the share code and add notes. When a candidate is moved into an Offer stage without a Verified status, Recruit warns you or stops the move, depending on how your organisation is set up.
Who can see and change it
There is no role restriction on right to work. Anyone who can open the candidate's profile sees the Governance tab and can change the status, add, edit, verify and delete documents, save the share code and write notes. Attaching a scanned file to a document is the exception: only System Admins and HR users can upload files. Other users can still add the document entry without a file.
The same tab holds the candidate's consent record and the data export and deletion controls. Those are for System Admins and HR users only, and are covered in Candidate data rights: export, deletion and consent and Recording a candidate's consent. Consent is separate from right to work, and changing one does not affect the other.
Recording a right to work check
- Open the candidate and select the Governance tab.
- In the Right to Work card, use Update Status to choose the status. It saves as soon as you pick it and you see Saved successfully.
- Under Documents, select Add Document for each document you checked.
- If the candidate gave you a share code, enter it in UK Gov Share Code and select Save.
- Add anything worth remembering to RTW Notes.
Statuses
A candidate with no status recorded shows Not Started.
| Status | What it means |
|---|---|
| Not Started | No check has begun. |
| In Progress | You are collecting or checking documents. |
| Verified | The check is complete. This is the only status that satisfies the offer stage. |
| Expired | A previously verified check no longer holds, for example a visa has run out. |
| Failed | The check did not pass. |
When the status is Expired or Failed, a red message appears at the top of the card: "Right to work verification must be completed before an offer can be extended."
The status is always set by a person. Adding a document, marking a document verified, or a document passing its expiry date does not change it. Change it yourself with Update Status when the check moves on.
Adding a document
In the Add RTW Document window:
- Document Type (required): Valid Passport, Valid Visa/Work Permit, Biometric Residence Permit (BRP), UK Gov Share Code Verified, UK Birth Certificate or Other Document.
- Label (required, up to 255 characters): a name you will recognise in the list, such as "UK Passport".
- Expiry Date: optional. It is shown beside the document in the list.
- Attach File (optional): a scan of the document, up to 10 MB. PDF, Word (DOC and DOCX), RTF, plain text, OpenDocument text and HTML files are accepted. Images such as PNG and JPG are not, so save a photo as a PDF first.
- Notes: optional, up to 2,000 characters.
The Add Document button stays greyed out until you have chosen a type and entered a label. If the file upload fails, nothing is saved, so fix the file and try again.
Working with documents in the list
Each document shows its type, its expiry date if you gave one, and any notes. The icons on the right do the following:
- The eye opens an attached file in a new tab, and the download arrow saves it. Both only appear when a file is attached.
- The pencil edits the label, expiry date and notes. The document type cannot be changed, so delete the entry and add a new one if you chose the wrong type.
- The tick marks the document as verified. The row turns green and shows Verified with the date you marked it. The same button becomes a cross, which marks it unverified again and clears the date.
- The bin deletes the document after you confirm with Delete. This cannot be undone.
Verifying a document is a record of what you looked at. It is separate from the candidate's overall status.
Share code and notes
Select the UK Gov Share Code box to edit it, then Save or Cancel. The code can be up to 100 characters. Check on GOV.UK opens the government's right to work checking service in a new tab. Recruit does not look the code up for you, so record the outcome with the status and, if you want a record of it, a document of type UK Gov Share Code Verified.
RTW Notes is free text for the candidate as a whole, up to 2,000 characters. Select it to edit, then Save.
What the offer stage does
The check happens when a candidate is moved into a pipeline stage whose stage type is Offer. If their status is anything other than Verified, including Not Started and In Progress, one of two things follows.
- Warn (the default). The move goes ahead. A warning appears beside "Candidate moved successfully": "Right to work verification has not been completed. Please ensure compliance before making an offer."
- Block. The move is refused. The person moving the candidate sees "Failed to move candidate" with the reason "Right to work verification must be completed before progressing to the offer stage." The candidate stays in their current stage until the status is set to Verified.
Which of the two applies is a setting on your organisation. Every organisation starts on warn. There is no control for it in Settings, so if you want moves blocked, ask HireRoad support to switch it on.
Moving several candidates at once applies the check to each of them. Where your organisation blocks, those without a Verified status are left where they are and counted in the failed total in the message, for example "3 moved, 1 failed".
The check is tied to the stage move. Once a candidate is in an Offer stage, later changes to their status do not move them back.
History and documents from candidates
Changes to right to work appear on the candidate's Timeline tab as RTW Updated (with the old and new status), RTW Document Added, RTW Document Updated and RTW Document Removed.
A file a candidate uploads in answer to a document request, including one of type Right to Work, lands in the Documents section of their profile. It does not create an entry in the Right to Work card or change the status, so review the file and record the check here yourself. Sending the request is covered in Requesting a document from a candidate.