Skip to main content

Set up Job fields

  • SmartRecruit


In SmartRecruiters, Job fields are the key to customizing the details of your jobs and applying different email templates, approvals, screening question sets, and other configurations for individual jobs or groups of jobs.

Job vs Org fields

Each SmartRecruiters account has a library of Job fields. Admins can manage their fields from the Job Fields page in Settings / Admin.



All SmartRecruit accounts come with three default Org fields:

  • Department
  • Brand
  • Country

Set up departments

Departments in SmartRecruiters serve a variety of purposes:

  • Candidates can filter jobs on your Job WidgetCareer Page, or Facebook page by department.
  • You can set up specific Career pages for individual departments.
  • You can configure screening question sets, email templates and other features for certain departments.
  • Administrators and Extended users on your account can use the Analytics tools to track candidates and hiring progress by department. 

To set up departments:

  1. Navigate to the Settings / Admin page.
  2.  Click Job Fields in the Configuration list.
  3. Click the edit icon for the Department field.JobFieldsListDEFAULT.png
  4. To make the field required in the Job Posting Wizard, select Yes for the Required option.AddDepartmentValues.png
  5. Enter a department name into the Field Values input field, and press Enter to immediately save it. AddDeptvalues.png
  6. Continue to add more values as necessary.

You can also add Department names in bulk by uploading a .csv file. Format this .csv file with a single column and a single value in each row:


To upload the file:

  1. Click Options.UploadFieldValuesCSV.png
  2. Click Add from CSV.
  3. Find the file on your desktop and upload it.

Create Job or Org field 

Companies with the SmartGlobal add-on can add custom Job and Org fields. There is a limit of 200 Job fields - this is inclusive of both active and inactive fields. There are also a maximum of 22 custom Org fields (in addition to Brand, Department and Country).

Want this feature? Ask your Customer Success Manager about the SmartGlobal add-on.

Create field

To create a new custom Job or Org fields:

Only Admin users can set up Job or Org Fields.

  1. Navigate to Settings / Admin.
  2. Click Job Fields in the Configuration list.
  3. Click Add Field.


  4. Add the field's details:ConfigOrgField.png
    1. Give it a name (up to 200 characters);
    2. For type, choose between Single select (a dropdown list) or Free Text (free entry). Free text fields are not reportable in the Job Fields report or via the API.
    3. For category, choose Job or Org Field. The category cannot be edited after you create a field.
    4. Make it required (if necessary)
    5. Choose its visibility.

Add values

New fields are not active until you add at least one value.

Each field can have up to 6,000 values. Each value is limited to 200 characters.

  1. Add in the values manually, or click Add from csv to upload the values in a .csv file.


  2. When your job creators go to pick values from this field, they'll see the values in the same order shown here. You can change this order in one of three ways:ManuallyOrderFieldValues.png
    • Click the handle for a value and drag it up or down in the list.
    • Select Sort A-Z to sort them alphabetically.
    • Click Show order number and enter a number for each item as necessary.
  3. Click Save to complete the field and save it. 

Org Fields can be used to configure features, like email templates and Access Groups, for specific groups of jobs.