> ## Documentation Index
> Fetch the complete documentation index at: https://help.journeyfront.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> This is the Journeyfront Help Center for hiring teams. Journeyfront is an applicant tracking system (ATS). Use the Help Center's terms: job req, Candidate Profile (the person), Candidate Application (one person on one job req), hiring class. Link to the article you used in your answer.

# Onboarding forms

> Collect new-hire information and documents before day one, right in Journeyfront.

> [!NOTE]
>
> **Who can do this:** Admins with *Company Settings Access* build onboarding forms. Users with the *Manage Job Req Settings* permission add them to a job req's workflow. Anyone who can open a candidate can send them a form and review what they submitted.

Onboarding forms replace the paper packet and the back-and-forth of emailed attachments. You build a form once, with the fields, documents and acknowledgments you need, and attach it to the step in a job req's workflow where onboarding starts. When a candidate reaches that step, they get the form, fill it in on any device, and everything they submit is saved on their Candidate Application.

## How it works

**1. Build the form**

In **Settings**, create a form with the fields, instructions and consent forms you need.

![The Edit Onboarding Form page in Settings for the active form New Hire Packet - US, with its content highlighted: the Add button, a Personal Information section and a required Home address field](https://mintcdn.com/journeyfront/PQrdl_4IlrPf8aOR/images/onboarding/onboarding-forms/onboarding-form-build.png?fit=max\&auto=format\&n=PQrdl_4IlrPf8aOR\&q=85\&s=1b4592797a8ce13879ddb830e1e67cf4)

**2. Add it to the workflow**

Add an **Onboarding Form** activity to the right step of the job req's workflow, and choose the form it uses.

**3. Send it**

When candidates reach that step, the form is assigned to them, and emailed if you've turned that on. You can also send a form to one candidate yourself.

![The Onboarding tab of a Candidate Application in the slide-out panel, with the Select Onboarding Form window open: New Hire Packet - US chosen, Send Invite to Candidate on, and the Confirm button](https://mintcdn.com/journeyfront/PQrdl_4IlrPf8aOR/images/onboarding/onboarding-forms/onboarding-select-form.png?fit=max\&auto=format\&n=PQrdl_4IlrPf8aOR\&q=85\&s=c57111e0fd11295d0268b3e8ffb29063)

**4. Review and complete**

Check what they submitted on the **Onboarding** tab of their Candidate Application, then mark it complete.

## Build a form

**1. Open Onboarding Forms**

Go to **Settings**, then **Onboarding Forms**, and click **Create New Form**.

![Settings, Onboarding Forms with six forms listed by name, creator, Active or Inactive status and last update, and the Create New Form button highlighted](https://mintcdn.com/journeyfront/PQrdl_4IlrPf8aOR/images/onboarding/onboarding-forms/onboarding-forms-create.png?fit=max\&auto=format\&n=PQrdl_4IlrPf8aOR\&q=85\&s=7a83ee535b452b2cd0ad6f6410dd0eef)

**2. Name and activate it**

Under **Form Settings**, enter the **Onboarding Form Name**. Turn **Activate Onboarding Form** to **Yes** so the form can be used.

**3. Add content**

Click **Add** and choose what to add. Drag items by their handle to put them in order.

**4. Preview and save**

Click **View Form** to see the form the way candidates will. Then click **Save** (or **Update** when you're editing a form).

| Add | What it is | Options |
| - | - | - |
| **Add Section** | A heading that groups the items below it | **Section Name**, **Section Description**, **Hide from Candidate View** |
| **Add Rich Text** | Formatted instructions or policy text | The text itself |
| **Add Field** | A question, picked from your account's personal and application fields or the standard address fields | **Display Name** (what the candidate sees), **Candidate Help Text**, **Required**, **Hide from Candidate View** |
| **Add E-Consent Form** | One of your consent forms, which candidates sign with a checkbox and their typed name | **Required** |

![The Create Onboarding Form page in Settings with the form name, Activate Onboarding Form set to Yes, the Add menu open, and section, rich text, field and E-Consent cards below](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/onboarding/onboarding-forms/gen-form-builder.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=ab49da66c740f96dbdaee2346b84ee69)

Because form fields are your custom fields, a candidate's answers are saved to those fields, the same ones you see on their Candidate Application's **Details** tab. A field can only be on a form once, and each field needs its own display name.

> [!TIP]
>
> Need a field that isn't in the list, like a photo ID upload or a uniform size? Create it first in **Settings**, then **Custom Fields**, as a personal or application field. Use the **File Upload** type for documents, and mark sensitive fields **Private**. See [Custom fields](https://help.journeyfront.com/account-setup/custom-fields.md).

Use **Hide from Candidate View** for things your team fills in, like an internal badge number. Candidates don't see them, but your team can complete them on the **Onboarding** tab.

To manage your forms, use the menu on each row of the **Onboarding Forms** list: **View Form**, **Edit Form** or **Delete Form**. The list shows each form's **Status** (**Active** or **Inactive**). Only active forms can be chosen for a job req or a candidate.

## Add a form to a job req's workflow

**1. Open the workflow editor**

Open the job req and go to **Setup**, then **Workflow**. Click **Create New Version** (or **Edit Draft** if there's already a draft) to open the editor.

**2. Add the activity**

In the building blocks on the left, find **Onboarding Form** and drag it into the step where onboarding should start. Many teams add a step just for it, for example after the offer step.

**3. Choose the form**

Click the activity to open its settings on the right. Under **Select a default onboarding form**, pick the form. Below it, **What the candidate sees on this form** previews it.

**4. Decide whether to send it automatically**

Turn **Auto-invite candidate to onboarding form** to **Yes** to email candidates the form as soon as they reach this step.

**5. Save and publish**

Click **Save Draft**, then **Publish** when you're ready. See [Publish workflow changes](https://help.journeyfront.com/workflows/publish.md).

![The workflow editor with the Onboarding Form building block, an Onboarding Form activity selected in the Onboarding step, and its settings on the right: the default form, Auto-invite set to Yes, and a preview of what the candidate sees](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/onboarding/onboarding-forms/gen-workflow-activity.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=9ea1adfc1b4ad910cf8f662f07dd0bd6)

On the job req's **Workflow** page, click the activity to see which **Form** it uses, whether **Auto-invite candidate** is on, and a preview of the form.

## Send a form to candidates

There are three ways a candidate gets their form:

* **They reach the step.** The activity's default form is assigned to them. With **Auto-invite candidate to onboarding form** on, they're emailed straight away.
* **You move them with Change Step.** When the step you're moving them to has an Onboarding Form activity, the **Change Candidate Step** window asks which **Onboarding form** to assign and whether to **Send Invite Email**. Choosing a form is required to move them. See [Move candidates through steps](https://help.journeyfront.com/candidates/move-through-steps.md#moving-actions).
* **You send it from their Candidate Application.** On the **Onboarding** tab, click **Select Form** next to the activity. In the **Select Onboarding Form** window, choose the form, leave **Send Invite to Candidate** on to email them, and click **Confirm**. **Select Form** appears when no form has been assigned yet.

The invite uses the **Onboarding Form** system email, with the subject "Please Complete Your Onboarding Form" and your company name. You can edit it in **Settings**, then **Templates**, then **E-mail Template**, on the **System Emails** tab. See [Email templates](https://help.journeyfront.com/communication/email-templates.md).

> [!TIP]
>
> Send the form as soon as the offer is accepted, not on the first day. Candidates have time to gather documents, and your team has time to chase anything missing before training starts.

## What candidates see

The email links to their form. They see your sections, instructions and questions, with any help text under each one. Required questions must be answered, and consent forms are signed with a checkbox and their typed name. When they click **Next** at the end, the form is submitted and they see "Thank you for completing your onboarding form".

See [E-consent forms](https://help.journeyfront.com/onboarding/e-consent-forms.md) for how consent forms work.

## Review and complete a form

Open the Candidate Application and click the **Onboarding** tab. Each Onboarding Form activity in the workflow has its own row, with its status:

<table>
  <colgroup>
    <col width="164" />

    <col width="526" />
  </colgroup>

  <thead>
    <tr>
      <th>Status</th>
      <th>What it means</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>**Not Sent**</td>
      <td>The form hasn't been sent to the candidate.</td>
    </tr>

    <tr>
      <td>**Sent To Candidate**</td>
      <td>The form has been sent.</td>
    </tr>

    <tr>
      <td>**In Progress**</td>
      <td>The candidate has started.</td>
    </tr>

    <tr>
      <td>**Submitted**</td>
      <td>The candidate submitted the form.</td>
    </tr>

    <tr>
      <td>**Complete**</td>
      <td>Your team marked it complete.</td>
    </tr>
  </tbody>
</table>

Click a row to expand it and see the answers. You can fill in or correct values right there, including fields hidden from the candidate. Uploaded files open in a new tab, and signed consent forms can be opened to view the signed record. Fields marked private only show to users whose security role has *Private Data Access*.

When everything's in, open the row's menu and click **Set To Complete**.

![The Onboarding tab of a Candidate Application with a Submitted onboarding form expanded, showing its answers, an uploaded file and a signed consent form, and the row menu open on Set To Complete](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/onboarding/onboarding-forms/gen-onboarding-tab.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=5527ee87f19c93ade3ba9d32d6a95810)

The **Onboarding** tab also shows the candidate's background checks. See [Background checks](https://help.journeyfront.com/onboarding/background-checks.md).

> [!TIP]
>
> To act on submitted forms without checking each candidate, add an automation rule with the **Activity Status Changes To** trigger, your onboarding activity and the status **Submitted**, for example to assign a coordinator or move the candidate to the next step. See [Automation rules](https://help.journeyfront.com/workflows/automation-rules.md).

## FAQ

> [accordion] Can candidates upload documents?
>
> Yes. Add a **File Upload** personal or application field to the form. Create the field in **Settings**, then **Custom Fields** first if you don't have one.

> [accordion] Can I use different forms for different roles?
>
> Yes. Each job req's Onboarding Form activity has its own default form, and you can choose a different form for one candidate when you move them or send it from the **Onboarding** tab.

> [accordion] Why isn't my form in the list when I set up the activity?
>
> Only active forms are listed. Edit the form in **Settings**, then **Onboarding Forms**, and turn **Activate Onboarding Form** to **Yes**.

> [accordion] Why can't I move a candidate into the onboarding step?
>
> The **Change Candidate Step** window needs an onboarding form chosen before it lets you continue. Pick a form under **Onboarding form**.

> [accordion] Where do the answers go?
>
> Into the candidate's personal and application fields, so they show on the **Details** tab and can be added as columns and filters on the Candidates page. Personal fields belong to the person, so their answers show on all of their Candidate Applications.

> [accordion] Are onboarding forms legally binding signatures?
>
> Consent forms on an onboarding form are signed with a checkbox and a typed name. For offer letters and other documents that need a full e-signature, use offers with e-signatures. See [E-signatures](https://help.journeyfront.com/offers/e-signatures.md).

> [accordion] Can I change the email candidates get?
>
> Yes. Edit the **Onboarding Form** template on the **System Emails** tab in **Settings**, then **Templates**, then **E-mail Template**.

## Related

> [card] [E-consent forms](https://help.journeyfront.com/onboarding/e-consent-forms.md)
>
> Consent forms candidates sign during the application or onboarding.

> [card] [Custom fields](https://help.journeyfront.com/account-setup/custom-fields.md)
>
> The fields your onboarding forms collect.

> [card] [Hire candidates](https://help.journeyfront.com/onboarding/hire-candidates.md)
>
> Mark candidates as hired.

> [card] [Build a workflow](https://help.journeyfront.com/workflows/build.md)
>
> Add steps and activities to a job req.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.