---
title: "Candidate checks via Humanforce"
slug: "candidate-checks-via-humanforce"
updated: 2026-05-31T06:12:47Z
published: 2026-05-31T06:12:47Z
canonical: "docs.checkmate.tech/candidate-checks-via-humanforce"
---

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

# Candidate checks via Humanforce

@(Embed)(https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/candidate_checks_via_humanforce.mp4){width="100%"}
<br>
Once the Humanforce integration is set up, you can launch background checks and track their progress without leaving Humanforce.

If you haven't set up the integration yet, see [Setting up the Humanforce integration](/v1/docs/setting-up-the-humanforce-integration) before continuing.

## Assign a bundle to a job in Humanforce
This step only needs to be completed once per job.

1. In Humanforce, click **Jobs** and navigate to the job you want to run checks for.

![navigate to Jobs view](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/01_humanforce_checks_select_jobs.png){height="" width=""}

2. Click the ⋮ menu and select **Edit job Details**.

![select Edit Job Details](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/02_humanforce_checks_job_details.png){height="" width=""}

3. Scroll down to the Checkmate section and set **Does this job require a Checkmate check?** to **Yes**.

![choose Yes](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/03_humanforce_checks_checkmate_details.png){height="" width=""}

4. Select the Checkmate bundle you would like to use for this job in the **Select your Checkmate package** dropdown.

![select Checkmate bundle](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/04_humanforce_checks_select_checkmate_bundle.png){height="" width=""}

5. Click **Save**.

![click Save](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/05_humanforce_checks_click_save.png){height="" width=""}

## Launch checks within Humanforce
1. From the Jobs page, click on the relevant job to open the candidate list.

![select the job](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/06_humanforce_checks_select_job.png){height="" width=""}

2. In the **Status** column, click the candidate's current status to open the **Status Change** window.

![click on the status](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/07_humanforce_checks_click_status.png){height="" width=""}

3. Change the candidate's status to **Checkmate Requested** and click **Save**.

![select Checkmate Requested](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/08_humanforce_checks_checkmate_requested.png){height="" width=""}

4. Refresh the page — the candidate status should update to **In Progress**.

![In Progress status](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/09_humanforce_checks_in_progress_status.png){height="" width=""}

## Monitor progress
:::(Info) (Note)
The **Hide Widget** setting in Checkmate must be toggled off to view check progress and results within Humanforce.
:::

To monitor the progress of checks, click on the candidate and select the **Activity** tab. Follow the link to view the candidate details and monitor process.

![Activity tab](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/10_humanforce_checks_candidate_activity_tab.png){height="" width=""}

The following 3 tabs allow you to view progress and edit candidate details:

**Background Checks** - From here you can view the status of the check, add additional checks using the **Add Checks** button and download results when checks are complete.

**Candidate** - This tab allows you to update the candidate's details at any time during the background check process.

**History** - This tab shows a chronological log of events related to the candidate's background screening process.

![3 Candidate profile tabs](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/03_widget_monitoring_progress.gif){height="" width=""}

## View results
Once all checks are complete, the candidate status will automatically update to **Checkmate Completed**. Results can be viewed and downloaded via the candidate's **Activity** tab (provided the **Hide Widget** toggle is disabled).

Result files can be downloaded via the **Background Checks** tab when the check has been completed.

![View results](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/04_widget_view_results.png){height="" width=""}

{{snippet.NeedHelp}}