How to: Add custom fields for an HRIS Link integration


HRIS Link makes it easy to import any and all data from your HRIS into Greenhouse Recruiting in the form of custom fields. This article outlines how HRIS Link maps report fields to Greenhouse Recruiting fields, and how to incorporate new data fields into your integration.

In order to map each report field to a Greenhouse Recruiting custom field, HRIS Link looks for a basic text match between the report column header and the following Greenhouse Recruiting custom field attributes (in order):

  1. Immutable field key
  2. Field name

Note: When performing the text match, HRIS Link replaces all underscores (“_”) with spaces, and ignores casing.

If HRIS Link cannot find an immutable field key that matches the report column header, HRIS Link looks for a match on the field name itself.


Note: Immutable field keys are generated automatically at the time of custom field creation in Greenhouse Recruiting. Open a ticket with the Greenhouse Support team if you need to modify an immutable field key.

Follow the steps below to add a new field to HRIS Link:

  1. Create the new custom field in Greenhouse Recruiting (Configure Configure.png > Custom Options > Jobs > Add Field), making note of the field name and immutable field key, as pictured above.
  2. If the Greenhouse Recruiting custom job field is a single select or multi select field type, make sure you add all option values that exist in the HRIS. You can use custom field options syncing to automate this step.
  3. Add the new data field to your HRIS Link report, using a column header value of either the immutable field key (recommended) or the custom field name, from step 1.
  4. Verify the newly added field appears on the HRIS report with the correct column header.

Once the above steps are completed, HRIS Link imports values from the newly added field on the next integration run.

If any errors occur, please review the following troubleshooting article before submitting a ticket to the Greenhouse Support team: Troubleshoot: Import jobs

Click here to open a ticket with the Greenhouse Support team if you require further support. 


Additional resources: