Forms allow your organization to collect additional structured data about a candidate after they have entered your system. Forms are created per job rather than organization wide. For more information about how to manage Forms across multiple jobs, click here. I

n this article, we will cover the various components of creating a Form:

To start, click the All Jobs tab from your navigation bar and select a job from the subsequent list. 


From the Job page, click Job Setup and navigate to Forms on the left-hand panel.


Click Create a Form.



Copy from Existing Form

The Create a Form page, allows you to create a Form for this specific job. By default, the Form and all of its details are blank. However, if you would rather copy a Form from another job to use as a template, use the Copy from existing form feature to copy a Form from any job where you have Job Admin level access or above. 

Note: Alternatively, you can create a new Form from scratch without copying an existing Form. 

To copy an existing Form from another job, navigate to the Copy from existing form dropdown menu on the right-hand side. Select a Form from the dropdown menu. 


Once the existing Form is copied to your current workspace, you can edit the details of the new Form (if necessary) without altering the original Form. 

Click Save when finished.


Configure Email to Candidate

All Forms are sent to candidates via an email that includes a special {{FORM_LINK}} token. 

Note: Since Forms are accessed through a token included in an email, you can only send Forms to candidates who have an email address associated with their profile.

From the Email to Candidate panel, choose from the From dropdown menu whether the email should be delivered directly from your user account or from no-reply@greenhouse.io


Next, configure the subject heading and body of the email using the available tokens in the right-hand panel.

Note: Remember to include the {{FORM_LINK}} token in the body of the email so that candidates can navigate to the actual Form.


Configure Form

When clicked, the {{FORM_LINK}} will direct candidates to the Form configured in this step. Navigate to the Form panel, and give the Form a candidate-facing name and an optional description.


Click the appropriate button to add a question, section header, or statement to the Form.

Note: Every Form must include at least one question.



As the name implies, adding a question to the form allows you to pose a question to the candidate with the intention that it will be answered. 

From the Add Custom Question dialog box, input your question into the provided field and select whether a response is required.


Next, use the Answers dropdown menu to select how the candidate should respond to the question. Use the below table to help you understand what each answer option entails:

Answer Type Notes
Link answers to custom field on candidate's profile

Choosing this option allows you to link the candidate response to an existing field on the candidate's profile. This will allow your organization to aggregate these responses in reports that allow custom fields.


Note: Only the following custom field types are supported when linking answers to custom field on candidate's profile: 
  • Short Textbox
  • Long Textbox
  • Yes/No
  • Single Select
  • Multi Select
Short Textbox --
Long Textbox --
Single Select Candidates will select 1 answer out of the list of provided options. When configuring, place each option on it's own line.
Multi Select Candidates can select multiple answers out of the list of provided options. When configuring, place each option on it's own line.
Yes/No --

Candidates can upload an attachment in response to the question and/or satisfy the answer requirement. Greenhouse Recruiting supports the following attachments on job forms:

  • pdf
  • doc
  • docs
  • rtf
  • txt
  • jpeg
  • png

Attachments can be downloaded from the candidate's profile.

Next, decide whether you would like to mark the question as private. Only users with one of the permission configurations listed below can view candidate responses to questions marked as private. For more information, please click here.

  • Site Admins with the user-specific permission Can see private notes, salary info, manage offers, and approve job/offers, or 
  • Job Admins with the permission stripe Can view and edit private candidate and application fields


Note: Responses linked to a custom field on a candidate's profile automatically inherit that field's permissions policy.

When finished, click Save to add the question to the Form.


Section Header

A section header allows you to visually organize a form into different sections that contain relevant questions/statements. 





Statements allow you to provide contextual information throughout the Form and to possibly introduce each new section. Unlike questions, statements do not require any response from the candidate.



Reorder Form Components

To reorder any question, section header, or statement in the form, simply click and hold Screen_Shot_2018-11-26_at_2.23.21_PM.png to the left of the Form component and drag to the desired position. When finished, release. 



Form Settings

The Form Settings panel allows you to determine when users are notified that a Form needs to be sent and who is notified when a candidate submits a response. By default, the Forms to send task will always be assigned to the Recruiter on the job. For more information, click here.

Use the Stage dropdown menu to decide when the Forms to send task will be triggered for Recruiters. It is not necessary to tie a Form to a particular Stage; however, without this setting, the Forms to send task will never be created.


Note: If a Form is retroactively tied to a particular Stage after the Form has been created, the Forms to Send tasks is created for all candidates who are currently in or have passed the stage and is displayed as overdue.

Next, assign all users who should be notified of a candidate submissions. Notifications can be assigned to whichever user is assigned to the recruiter and/or coordinator role, and specific users as well.