Increase control over your job ads and highlight important information from your candidates internally by using Custom fields. This feature allows you to add additional fields in your job postings and candidate cards that you can fill with information specific to your company.
Start by heading over to Settings → Recruitment → Custom fields, where you create and edit your custom fields. And now, let’s take a closer look at Custom fields for your candidate cards and Custom fields for your job postings.
Custom fields for candidates
A custom field appears at the top left-hand side of your candidate's profile and is a great place for you to make sure you have the information needed for a fair and good assessment.
Pro tip! Learn how you can populate your candidate custom fields automatically based on answers from your candidate in this support article.
Field types
Field type | Description |
Text | A single-line text box is added to the candidate’s profile |
Number | Allows you to add a number value |
Select | A dropdown selector that allows a single option to be selected |
Multi-select | A dropdown selector that allows several options to be selected |
True/False | True or False selector (Boolean) |
Date | Date selector from a calendar |
Field to leave an email address, which is later clickable with a mailto function | |
Phone | Field to leave phone address, which is later clickable with a tel function |
URL | Field to add a URL, which then gets clickable and opens in another tab of your browser |
Field settings
Your field comes with three additional settings, allowing you to customize the candidate card even more.
Private: A private field will only be visible and editable for users with access as Recruitment Leads, and all Recruitment & Company Admins
Featured: This field will always show, even if it’s empty*
Do not show in internal filters: Hides the field from the candidate filters in your candidate bank
Format validation: If you want the candidate custom field to follow a specific format.
* By default, the custom fields are hidden if empty, so you can focus on the information that is actually added there! Any empty field can be found under the filled fields, like so:
API settings
You can also set to use a custom field as an API Field. This means the field is not visible on the candidate but can be set from the API. Under API Name, you can select what name this field will have in the API.
Custom fields for job postings
Custom fields for job postings is a great way to include all the relevant information for the recruitment process you’re working on.
Field types
First of all, you will see four Standard fields. These are pre-created fields, there to make your setup easier. Note that these fields are by default visible on the job ad.
Field type | Description |
Remote status | Show the remote status of the job. Options included are:
|
Salary | Display what salary a candidate could expect in this position. You can choose to add a fixed number or a range, as well as include the currency and payment frequencies. |
Employment type | Include information about employment types. Options included are:
|
Employment level | State employment levels for this role. Options included are:
|
Need something else? No worries - you can also create Custom fields and include whatever information you need. The available fields are the same as listed under the Candidate custom fields.
Field settings
Visible in job ad: Any field that you’ve set to be visible on the job ad will be displayed at the bottom of your job posting, under a section titled Additional information. It will look something like this:
Required: The field will be mandatory to fill out before the job can be published. All mandatory fields will be marked with an asterisk *.
Do not show in internal filters: The field is hidden from filters in the overview under Jobs inside the platform.
Format validation: If you want the job custom field to follow a specific format.
Use job fields in filters
When you use job fields, you can use them to filter in the job list tab. The field types available for filter are:
Yes/No
Multi-select
Select (single option)
Number
Date
API settings
You can also set to use a custom field as an API Field. This means the field is not visible on the candidate but can be set from the API. Under API Name, you can select what name this field will have in the API.
Custom fields for job offers
When using our Job offers add-on feature, you can include additional information through custom fields. Create fields you want your users to choose from when creating job offers or include them in job offer templates.
Field types
Field type | Description |
Text | A single-line text box is added to the job offer |
Number | Allows you to add a number value |
Select | A dropdown selector that allows a single option to be selected |
Multi-select | A dropdown selector that allows several options to be selected |
Date | Date selector from a calendar |
Field settings
Internal: The field will only be visible to users within the platform and are never shown to the candidates.
Required: The field will be mandatory to fill out before the job offer can be sent. All mandatory fields will be marked with an asterisk *.
Format validation: If you want the job offer custom field to follow a specific format.
Use format validation
In the Field settings section of the custom field setup, you can enable Format validation. This option can be used when you want a text custom field to follow a specific format. This helps ensure that the information is added in a consistent format.
Teamtailor will then check that the entered value matches the format you set, both in custom fields within Teamtailor and in questions connected to a custom field using format validation in:
Application forms
Questionnaires
Connect questions
Survey questions
Onboarding forms
Format validation is only available for Text custom fields.
Note that format validation only applies to new edits. If you turn it on (or change the pattern) on a field that already has data, existing values stay intact.
Set format
When you enable it, you’ll see two fields:
Regex pattern: The format the value must follow.
Example:
^[A-Z]{3}-\d{4}$= three uppercase letters, a dash, and four digits (ABC-1234).
Example value: An example value matching the set pattern shown as a hint to the person filling out the field.
Example:
ABC-1234= three uppercase letters, a dash, and four digits.
What’s a regex?
A regex (short for regular expression) is a way of describing what a piece of text should look like, using a small set of symbols. It’s a tool developers use a lot, but you can often find ready-made patterns online for the formats you need. A few common building blocks:
Pattern | Meaning | Matches |
\d | Any digit |
|
\d{4} | Exactly 4 digits |
|
[A-Z] | Any uppercase letter |
|
[A-Z]{3} | Exactly 3 uppercase letters |
|
^…$ | The value must match from start to end |
|
^[A-Z]{3}-\d{4}$ means: three uppercase letters, then a dash, then four digits, and nothing else. ABC-1234 matches, whereas abc-1234 or AB-1234 don’t.
Pick an example that’s easy to recognise. People filling out the field will see this hint, and ABC-1234 is a lot easier than reading the regex.
If your example doesn’t match the pattern, you’ll see a little warning. The example will still save, so you can use it for free-form explanations if you’d rather write a short description than a sample value.
Need help to build or test a pattern?
On the website regex101.com you can paste your pattern or example value, and it tells you whether it matches and explains every part of the pattern in plain English. Searching “regex for [what you want to validate]” can help you show a working pattern to copy.
Examples
Format validation helps keep data clean and consistent. It improves how data is stored within Teamtailor and sent through integrations by ensuring values are entered in the expected format.
Candidates: Use format validation for candidate custom fields.
Example setup
Custom field on candidate card
Question connected to custom field
Jobs: Use format validation for internal or public custom fields used within jobs.
Example setup
Custom field in job editing mode
Job offers: Use format validation for both internal and public custom fields in job offers.
Example setup
Custom field in job offer modal
Delete custom fields
A custom field can be deleted under Settings → Recruitment → Custom fields in the editing window. Note that when you delete a custom field, you will delete all of the information from the custom field for every candidate, job, and job offer.
Prefer reading in your own language? Check out our other support centers available at the top of the page 🌍