Custom flags
Turn a candidate tag into a small icon that shows on pipeline cards, and keep sensitive flags and scheme indicators away from hiring managers.
Turn a candidate tag into a small icon that shows on pipeline cards, and keep sensitive flags and scheme indicators away from hiring managers.
A custom flag is a name and an icon that you link to one candidate tag. Any candidate who carries that tag shows the icon on their card in a job's pipeline. Typical uses are Disability Confident, armed forces or care leaver status, or anything else your team needs to notice before opening the application. How the tag gets onto candidates is covered in "Tagging candidates so a custom flag appears".
Who can set up and see flags
System Admins and HR users can open Settings > Job Setup > Custom Flags, and both can create, edit and delete flags. Other roles cannot open the page.
The icons on pipeline cards are shown to System Admins and HR users only. Recruiters, hiring managers, interviewers, Members and Agency users do not see them, even though they can see the same candidates. If your organisation is a group parent, a company picker at the top of the settings page lets you choose whose flags you are working on.
Create a flag
- Go to Settings > Job Setup > Custom Flags.
- Select Add Flag. If you have no flags yet, the page says "No custom flags configured. Create your first flag to get started." and offers the same button.
- In Name, type what the flag means, for example Disability Confident. This is the text people see when they hover over the icon. The limit is 255 characters.
- Under Icon, choose one of the twelve icons. A preview underneath shows the icon next to your name.
- In Candidate tag, type the tag that triggers the flag, for example disability_confident. Use lowercase letters, digits and underscores only, up to 100 characters.
- Tick Visible to Admin and HR only if other users must not see the matching tags on candidates. See the last section of this article.
- Select Create Flag. You see "Flag saved" and the flag appears in the list on the left. Creating a flag is recorded in the audit log.
The Create Flag button stays disabled until both Name and Candidate tag are filled in. If the tag contains capitals, spaces or punctuation you see "Only lowercase letters, digits, and underscores are allowed". Each tag can be linked to one flag only. If another flag already uses it, the save fails with "A flag already maps to the tag" followed by the tag name. Use a different tag, or edit the other flag first.
Icons and colours
Each icon has its own fixed colour. You choose the icon and the colour comes with it. The icon is white on a solid coloured circle. New flags start with the Accessibility icon selected. Two flags can use the same icon, but they will look identical on a card, so give each flag its own icon where you can.
| Icon | Colour |
|---|---|
| Accessibility | Deep rose |
| Shield | Red |
| Heart | Pink |
| Star | Amber |
| Award | Gold |
| Lightning | Blue |
| Leaf | Green |
| Globe | Teal |
| Flame | Orange |
| Graduation Cap | Indigo |
| Users | Purple |
| Briefcase | Slate grey |
Where flags appear
Flags show on candidate cards in a job's Pipeline tab, in each stage, to System Admin and HR users. Each icon sits on the card below the candidate's details. Hover over an icon, or focus it with the keyboard, to see the flag's name.
A card shows up to four icons. If a candidate matches more than four flags, the rest are collected into a "+N more" badge, and hovering over it lists their names.
Flags do not appear on the Candidates page or on the candidate's own profile. There you see the underlying tag, in the Tags column and in the tag editor.
Edit or delete a flag
- Open Settings > Job Setup > Custom Flags.
- Select the flag in the list. The panel on the right changes to Edit Flag.
- Change the name, icon, candidate tag or question settings, then select Save. To go back to adding a new flag, select Add Flag below the list.
- To remove the flag instead, select Delete and confirm in the Delete Flag box. You see "Flag deleted".
Name and icon changes show on pipeline cards straight away, for every candidate who has the tag. If you change the Candidate tag, candidates who carry the old tag stop showing the flag and candidates who carry the new tag start showing it. Nobody's tags are changed.
When you delete a flag, candidates who already have the tag keep it, but it no longer shows as an icon. If you create a flag again with the same tag, the icons return for everyone who still has the tag. Deleting a flag cannot be undone, but an unmarked flag is quick to recreate. A flag marked Visible to Admin and HR only cannot be deleted, or have its tag changed, until you un-mark it.
Hiding sensitive flags and scheme indicators
Some flags, such as disability or reasonable adjustment flags, should not be visible to everyone. Tick Visible to Admin and HR only on Create Flag or Edit Flag. The help text reads "Hiring managers and other users will not see candidates' tags that match this flag." The flag then shows an Admin and HR only badge in the list on the left. Other roles stop seeing the matching tags on candidates, in filters, in search and in suggestions.
While a flag is marked, the Candidate tag box and Delete are disabled, with the line "Un-mark this flag as sensitive and save before changing its tag or deleting it." Un-marking makes the existing tags visible to other roles again. Changes to the marker are recorded in the audit log.
Below the flag editor, the UK inclusion schemes card does the same for three scheme indicators: Disability Confident scheme, Armed Forces Covenant and Care Leaver Friendly. Each has a switch labelled Visible to Admin and HR only. The card says "Choose which scheme indicators hiring managers and other users outside Admin and HR can see. Switched off, a scheme shows as today. Applies to candidates already in the system." A save shows "Scheme visibility saved". Admins can change the switches. HR users see the card read only. Changes are recorded in the audit log.