Skip to main content

Configure candidate fields

  • SmartRecruit


Candidate fields capture important information about individual candidates and store this information on the candidates' profiles.


You can set up custom candidate fields and choose from different types to capture the information you need for integrations, approvals, and more. 

Screen Shot 2016-12-15 at 4.48.16 PM.png


Candidate field types

There are 8 types of candidate fields. Each is named for the kind of value users can select:

  • Free text: large free text box, up to 20,000 characters each.
  • Date picker: select a date from a pop-widget.
  • Numerical: formatted for numerical values
  • Percent: formatted for percentage values
  • Currency: choose one of the global currencies that SmartRecruiters supports.
  • User Picker: pick from the list of current users in your SmartRecruiters account.
  • Yes / No: pick yes or no
  • Single select: dropdown list, up to 1,000 custom values and 1,000 characters per value

SmartRecruiters comes with a set of standard candidate fields with pre-defined names and field types. You can select one of these, or create your own custom field. 

Add standard field 

To add new standard candidate field:

  1. Go to Settings / Admin.
  2. Click Candidate Fields in the Configuration list.Screen Shot 2017-01-11 at 3.51.14 PM.png
  3. Click Add field to review the list of standard candidate fields.Screen Shot 2017-01-11 at 3.52.25 PM.png


Add custom field

  • SmartRecruit
  • +
  • SmartGlobal

SmartRecruit provides a default list of candidate fields. By adding SmartGlobal, you can create up to 500 active custom candidate fields.

If you don't see the field you want in the list of default fields:

  1. Go to Settings / Admin.
  2. Click Candidate Fields in the Configuration list.
  3. Click Add field. Screen Shot 2017-01-11 at 3.51.14 PM.png
  4. Open the Choose Field list, and click Create Custom Field.AddCustomCandidateField.png
  5. Choose one of the eight types from the list, and give it a name. 


Custom candidate field labels cannot start with a numeric character. They must begin with A-Z or else this negatively affects the functioning of merge fields.  

Configure field

Once you've picked a standard or custom candidate fields, you can configure its placement, visibility, whether it is required to be filled out and approvals:


Where does this field appear?

These options determine where SmartRecruiters should use the field:

  • Candidate Profile: the field will be added to the candidate's profile.
  • Offer Approval Form: when someone creates an offer, they can fill out this field. The field and its value will show up in the approval request email. 
  • New Hire Form: when someone hires a candidate, this field will be added to the New Hire form.

Offer approvals

Select this option to require re-approval if the field is edited once an offer is made. For example, if a candidate declines an offer and the hiring manager or recruiter changes the value for this field, they will need to resubmit the offer for approval.

Which users can see it?

Select which users can see see the field and its values:

  • Select all to allow anyone with access to the job to see the field and its values. 
  • Select users with full access to restrict visibility to users with full access to the job, such as  a Hiring Manager, Recruiter, Executive on the job's hiring team.

For which org field?

Finally, select whether the field should be added for all or specific candidates.

  • Choose All to apply the field to every candidate on every job.
  • Choose Only Some to limit the field to only a specific set of jobs.

Select one or more values for each of your company's active Org fields. Screen Shot 2017-04-18 at 9.29.53 AM.png

SmartRecruiters will add this field to the profiles of Candidates who apply to jobs with matching Org field values.