Skip to main content

Custom fields

Customize information fields for candidates, job postings, job offers, and compensation types

Use Custom fields to tailor the information you collect and display across your recruitment workflows. You can add custom fields to job postings, candidate profiles, and job offers to capture information specific to your company.

In the Compensation tab, you can manage the compensation types available in your organization.

Start by heading over to Settings → Recruitment → Custom fields to manage the custom fields and compensation settings.

Candidate custom fields

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

Email

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

Automatic updates

When this setting is enabled for a candidate custom field, it becomes available when setting up a Request missing info trigger used to collect missing information directly from candidates. Co-pilot identifies when the field is missing, includes a question about it in the questionnaire sent to the candidate, and automatically updates the field based on their answer.

Co-pilot matches the candidate's answer to the available options for the field, so the information is stored in the correct format. Any connected questions to the field will continue to work as before.

Every update is recorded in the Audit log, with Co-pilot listed as the actor.

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.

Job custom fields

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:

  • No remote work

  • Temporarily remote

  • Flexible remote

  • Fully remote

Compensation

Display the compensation a candidate can expect for this role.

You can choose which compensation types, currencies, and recurrence options should be available in your platform in the Compensation tab under Settings → Custom fields.

Employment type

Include information about employment types. Options included are:

  • Full-time

  • Part-time

  • Contract

  • Temporary

  • Apprenticeship

  • Internship

  • Volunteer

Employment level

State employment levels for this role. Options included are:

  • Executive/Senior Level

  • First/Mid Level Officials

  • Professionals

  • Technicians

  • Sales Workers

  • Administrative

  • Support Workers

  • Craft Workers

  • Operatives

  • Laborers and Helpers

  • Service Workers

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

Field setting

Description

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 the Jobs tab inside the platform.

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 a custom field to be used 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.

Job offer custom fields

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

Field setting

Description

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 *.

If you want the job offer custom field to follow a specific format.

Manage custom fields

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.

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

0, 1, … 9

\d{4}

Exactly 4 digits

1995, 0001

[A-Z]

Any uppercase letter

A, B, … Z

[A-Z]{3}

Exactly 3 uppercase letters

ABC, XYZ

^…$

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.

Compensation

In the Compensation tab under Settings → Recruitment → Custom fields, you can define how compensation should be categorized in your organization when using the job custom field Compensation. By configuring compensation types, currencies, and recurrence options to match your company's needs, you help create a consistent way to manage compensation information across your recruitment workflows.

Here, you can choose which options should be available for each compensation field and set a company default.

The Compensation type, Currency, and Recurrence fields will be prefilled with the default options set when creating a requisition *, job, job offer **, and job offer template**. The same applies when setting up approval flows for requisitions, jobs, and job offers. Users can still select a different available option if needed.

* Available if your company is using our add-on feature Requisitions

** Available if your company is using our add-on feature Job offers

Field

Description

Compensation types

Choose which compensation types should be available when adding compensation information. Hover over a compensation type to reveal the option to set it as the default. The available options are:

  • Salary

  • Gross salary

  • Net salary

  • Contract rate

  • Stipend

Currencies

Choose which currencies can be picked when adding compensation, and define your company default in the Default currency field.

Recurrance

Choose which pay periods should be available when adding compensation information. Hover over a pay period to reveal the option to set it as your company's default. Available options include:

  • Hourly

  • Daily

  • Weekly

  • Monthly

  • Yearly

Example of a job offer where AUD, EUR, and USD are available currencies, with USD pre-selected as the default.

Prefer reading in your own language? Check out our other support centers available at the top of the page 🌍

Did this answer your question?