> ## 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.

# Create and manage classes

> Create a hiring class, set its openings and dates, make it active, and keep it up to date.

> [!NOTE]
>
> **Who can do this:** Anyone on the job req's hiring team, or with the *All Job Req Access* permission. Setting up custom hiring class fields needs *Company Settings Access*.

A hiring class is one group of hires for a job req: a name, how many people you need, when they start and, optionally, the offer package they get. Create a class for each wave you're filling, make it active, and the job req's **Hiring Classes** tab tracks how close every class is to full. See the [Hiring classes overview](https://help.journeyfront.com/hiring-classes/overview.md) for when to use them.

## Create a class

**1. Open the job req's Hiring Classes tab**

Open the job req and click the **Hiring Classes** tab.

**2. Click Create Class**

Click **Create Class** at the right of the toolbar. The **Create Hiring Class** window opens.

**3. Fill in the details**

Enter a **Class Name**, which is the only required field, and anything else you know now. See [Class details](#class-details).

![The Create Hiring Class window with a class name, job title, 20 openings, the three dates, location, Offer Package set to Use the job's offer package, two custom fields, and the Create Class button](https://mintcdn.com/journeyfront/jgBPyq0oPVTYhwCy/images/hiring-classes/create/gen-create-hiring-class.png?fit=max\&auto=format\&n=jgBPyq0oPVTYhwCy\&q=85\&s=1a777b5571a3b12977ea2736d752a6e7)

**4. Click Create Class**

The class is created as a **Draft**.

**5. Make it active**

Click the class's **Draft** status and choose **Active**, or open the menu next to its name and click **Set To Active**. Candidates can only be added to active classes.

![The Hiring Classes list with the menu next to a new Draft class open, showing Edit, Set To Active, Set To Complete and Delete Class](https://mintcdn.com/journeyfront/jgBPyq0oPVTYhwCy/images/hiring-classes/create/gen-set-to-active.png?fit=max\&auto=format\&n=jgBPyq0oPVTYhwCy\&q=85\&s=83e5e8e194f06b810079b94581497cdb)

You can also create a class from **Classes** in the top navigation: click **Create Class** and choose the **Job Req** first.

> [!TIP]
>
> Name classes with the role and start month, like "Customer Care, March 2027". The name is what recruiters pick from when they assign candidates, so make it obvious which wave is which.

## Class details

| Field | What it's for |
| - | - |
| **Class Name** | The name everyone sees when assigning candidates and in reports. Required. |
| **Description** | Anything else your team should know, like the trainer or shift. |
| **Job Title** | The title for this class's hires. |
| **Number of Openings** | How many people you need. **Filled %** is hires divided by openings. |
| **Hiring Start Date** | When hiring started for this class. It's what **Days Given**, **Days to Fill** and **Days to Complete** are counted from. Leave it empty to use the date you created the class. |
| **Due Date** | When the class needs to be full. |
| **Candidate Start Date** | The class's first day of work. When you hire candidates in this class with **Hire**, it's filled in as their start date. |
| **External Reference ID** | The class's ID in another system, for integrations and exports. |
| **Location** | Where the class works or trains. |
| **Client Account** | The client this class is hiring for, if you hire on behalf of clients. |
| **Offer Package** | The [offer package](https://help.journeyfront.com/offers/offer-packages.md) this class's offers start from. **Use the job's offer package** keeps the job req's own package. |
| **Custom Fields** | Your company's own hiring class fields, if you've set any up. See [Custom hiring class fields](#custom-hiring-class-fields). |

> [!NOTE]
>
> A class's **Offer Package** is only used when the job req's Offer activity allows it, with **Use the candidate's hiring class offer package** turned on in the workflow. See [Offer packages](https://help.journeyfront.com/offers/offer-packages.md).

## Class statuses

| Status | What it means |
| - | - |
| **Draft** | Set up but not open yet. New classes start here. Candidates can't be added. |
| **Active** | Open for candidates. Only active classes appear when you assign candidates to a class. |
| **Complete** | Finished. No more candidates can be added, and the class counts toward **Completed Classes** and **Completed Class Fill Rate**. Candidates already in it stay. |

To change a status, click the status on the class's row and pick another one, or use **Set To Active**, **Set To Complete** or **Set To Draft** in the menu next to the class name.

## Edit or delete a class

Open the menu next to the class's name:

* **Edit** opens the **Edit Hiring Class** window with every field. Click **Update Class** to save.
* **Delete Class** deletes it, after you confirm. You can only delete a class with no candidates in it; remove or move its candidates first. Deleting can't be undone.

> [!TIP]
>
> Rather than deleting a finished class, set it to **Complete**. It keeps its history, and your fill rate and time-to-fill numbers stay accurate.

## The Hiring Classes tab

The tab shows the job req's classes, with summary tiles above the list:

| Tile | What it shows |
| - | - |
| **Total Hiring Classes** | Classes that match your current filters |
| **Active Classes** | Classes with **Active** status |
| **Completed Classes** | Classes marked **Complete** |
| **Completed Class Fill Rate** | Average share of openings filled across completed classes |
| **Avg. Days Given to Fill** | Average days from hiring start date to due date |
| **Avg. Days to Fill Class** | Average days from hiring start date to every opening being filled |
| **Avg. Class Size** | Average number of openings |

Each class's row shows its **Status**, **Created** date, **Hiring Start Date**, **Due Date**, **Days Given**, **Days Left**, **Candidates**, **Hired**, **Openings** and **Filled %**, and you can edit **Client Account** right in the list. Use **Edit Columns** to add more, like **Candidate Start Date**, **Date Filled**, **Days to Fill**, **Rejected**, **Offer Package** or your custom hiring class fields.

**Filters** and [saved views](https://help.journeyfront.com/lists-and-exports/saved-views.md) work the same way as on the Candidates page, including sharing views with your team. To download the list, click **Actions**, then **Export Data**. **Classes** in the top navigation shows the same list for every job req at once, with a **Job Req** column.

## Custom hiring class fields

To track something every class needs, like a training room or a client's cost center, add a hiring class field: go to **Settings**, then **Custom Fields**, then **Hiring Class Fields**. Your active fields appear in the **Custom Fields** section of the create and edit windows, as columns and filters on the hiring classes list, and as merge keys for offer documents. See [Custom fields](https://help.journeyfront.com/account-setup/custom-fields.md).

## FAQ

> [accordion] Why can't I add candidates to my new class?
>
> New classes start as **Draft**. Set the class to **Active**, and it appears when you assign candidates.

> [accordion] Why is Delete Class greyed out?
>
> The class still has candidates in it. Remove them, or move them to another class, first.

> [accordion] What's the difference between Hiring Start Date and Candidate Start Date?
>
> **Hiring Start Date** is when you started recruiting for the class, and drives the time-to-fill numbers. **Candidate Start Date** is the hires' first day of work, and is used as their start date when you hire them.

> [accordion] Does a class close itself when it's full?
>
> No. When hires reach the number of openings, the class records its **Date Filled**, but it stays **Active** until you set it to **Complete**.

> [accordion] Why can't I see some classes on the Classes page?
>
> Without the *All Hiring Class Access* permission, you see classes for the job reqs you're on. Ask your Journeyfront admin.

## Related

> [card] [Working with a class](https://help.journeyfront.com/hiring-classes/working-with-a-class.md)
>
> Add candidates, message them and hire the class.

> [card] [Hiring classes overview](https://help.journeyfront.com/hiring-classes/overview.md)
>
> When to use classes, and where to find them.

> [card] [Offer packages](https://help.journeyfront.com/offers/offer-packages.md)
>
> Give each class its own offer terms.

> [card] [Custom fields](https://help.journeyfront.com/account-setup/custom-fields.md)
>
> Add your own hiring class fields.


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