Tagging candidates so a custom flag appears
How a flag finds its candidates: the tag match, three ways to add the tag and how to apply it automatically from an application form answer.
How a flag finds its candidates: the tag match, three ways to add the tag and how to apply it automatically from an application form answer.
This is for System Admins and HR users who have already created a custom flag under Settings > Job Setup > Custom Flags. See "Custom flags" for creating one. A flag does nothing until candidates carry its tag.
How the tag mapping works
The Candidate tag is the link between a candidate and the flag. A candidate shows the flag when the tag on their record is exactly the same as the tag you entered. Tags are matched character for character, so a candidate tagged Disability Confident (capitals and a space) will not show a flag mapped to disability_confident.
It does not matter how the tag got onto the candidate. It can be added by a recruiter, by the bulk Add Tags action, or automatically from an application form answer. Because the flag depends on an exact match, type tags exactly as they appear in the Candidate tag field.
Add the tag to candidates
- To tag one candidate, open them and select the tag icon (Edit tags) next to their name. Type the tag in the custom tag box and select Add, or press Enter. To remove it, untick it in the same list. Changes save straight away.
- To tag many candidates at once, select them on the Candidates page, open Manage and choose Add Tags. Separate tags with commas and use the lowercase underscore form, for example: disability_confident, care_leaver. You can add up to 50 tags in one go to up to 100 candidates, and a candidate can hold 200 tags in total. Bulk removal is not possible.
- To tag candidates automatically from an application form answer, use the optional question setting described in the next section.
To find everyone who carries a tag, use the Tags filter on the Candidates page. It lists candidates with any of the tags you tick. "Selecting candidates and using bulk actions" covers the Candidates page tools in more detail.
Tag candidates automatically from an application form
Under Application form question (optional) the flag has two more fields:
- Question text: the wording of the question on your application form, for example Do you consider yourself to have a disability? Up to 1,000 characters.
- Trigger answer: the answer that should apply the tag, for example Yes. Up to 255 characters.
When a candidate submits your application form from the careers page, or an agency submits the application on the candidate's behalf, and the answer to that question matches, Recruit adds the flag's tag to the candidate. This also applies when a candidate finishes an application they saved earlier.
- Fill in both fields. With only one of them, nothing is applied.
- Make the question text match the question's label on the form. Capital letters and extra spaces are ignored, but any other difference in wording means it will not match. If you later reword the question on the form, update the flag to match.
- Choose the trigger answer. The answer can be typed text or a choice from a list or set of options. If several options can be ticked, the flag applies when one of them is your trigger answer.
The tag is added when the application is submitted. It is not added to candidates who applied earlier, and it is not added when a recruiter edits an application's answers afterwards. Answers that do not match leave the candidate's tags unchanged. Candidates are never untagged automatically.