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

# Build a workflow

> Add, name and order the steps of a job req's workflow, then add the activities candidates complete in each step.

> [!NOTE]
>
> **Who can do this:** Users with the *Manage Job Req Settings* permission. The **Setup** tab only appears for people with this permission.

A job req's workflow is the path every candidate follows: a series of **steps**, each holding the **activities** candidates complete, like screening questions, a typing test or an interview. You build and change it in the workflow editor. Your changes are saved as a draft and only reach candidates when you publish them. For how steps, activities and automation fit together, start with the [Workflows overview](https://help.journeyfront.com/workflows/overview.md).

## Open the editor

**1. Go to the Workflow page**

Open the job req and go to **Setup**, then **Workflow**.

**2. Open the editor**

Click **Create New Version** at the top right. The editor opens full screen.

![The Workflow page of the Customer Care Associate job req, showing Workflow 2.0 as the Latest version with its steps and activities, and the Create New Version button at the top right highlighted](https://mintcdn.com/journeyfront/MP6XVW1Unu3e4opR/images/workflows/build-a-workflow/workflow-create-new-version.png?fit=max\&auto=format\&n=MP6XVW1Unu3e4opR\&q=85\&s=261c1a5787c606c05d6f57bbe0c2804e)

If the job req already has a draft, the button reads **Edit Draft**, or **Edit Scheduled Version** when a version is scheduled, and the editor opens that version. Otherwise **Create New Version** starts you from a copy of the live version, and your changes become a new draft when you save.

The editor has three columns:

* **Building blocks** on the left: a **Search** box, **New Step**, and every type of activity you can add, in groups you can collapse. Your saved question templates sit under a collapsed **Templates** row in their group.
* **The title** at the top: the version's name. Click it to rename the version.
* **The flow** in the middle: **START**, your steps and their activities, then **HIRED** and **REJECTED**.
* **Settings** on the right for whatever you select in the flow.

![The workflow editor: the version name Workflow 3.0 as the title with the job req underneath, and the Review Changes, Exit, Save Draft and Publish buttons at the top. On the left are the building blocks with Search, New Step and collapsed Templates rows. The flow from START through the Screening and Simulation steps is in the middle. On the right are the selected Qualification Questions activity's settings: Estimated Time, Time Limit, the collapsed Instructions and Supporting Content sections and its list of questions.](https://mintcdn.com/journeyfront/vQCJ8-ZVzF3DfqCc/images/workflows/build-a-workflow/workflow-editor.png?fit=max\&auto=format\&n=vQCJ8-ZVzF3DfqCc\&q=85\&s=3fdc1084ed1a59f7b38c1f1eead2f0c3)

## Add and arrange steps

**1. Add the step**

Drag **New Step** from the building blocks into the flow, to where the step belongs. An outlined **New Step** slot shows where it will land.

![New Step being dragged from the building blocks into the flow, with the outlined New Step slot highlighted between the Screening and Simulation steps](https://mintcdn.com/journeyfront/vQCJ8-ZVzF3DfqCc/images/workflows/build-a-workflow/workflow-new-step-drag.png?fit=max\&auto=format\&n=vQCJ8-ZVzF3DfqCc\&q=85\&s=873b9955ced9c0e3278dba13ae555364)

**2. Name it**

Type the name in the step's name field. Candidates see step names on their progress page, so use names that make sense to them, like "Assessments" or "Interview".

![The new step named Assessment highlighted in the flow between the Screening and Simulation steps, with its automation and trash can icons](https://mintcdn.com/journeyfront/vQCJ8-ZVzF3DfqCc/images/workflows/build-a-workflow/workflow-new-step-named.png?fit=max\&auto=format\&n=vQCJ8-ZVzF3DfqCc\&q=85\&s=34a0d5485d4754585c5183951c5ea2e7)

**3. Put it in order**

Drag the step by its handle (the dotted grip to the left of its name) to where it belongs. Candidates move through steps from top to bottom.

To **rename** a step, click its name in the flow and type. To **remove** a step, click its trash can. Removing a step also removes its activities and the automation rules attached to them from your draft.

### How candidates move between steps

Candidates stay in their current step until your team moves them with **Change Step** or an [automation rule](https://help.journeyfront.com/workflows/automation-rules.md) moves them (the job req's **Gate Steps** setting, on by default).

> [card] [Move candidates through steps](https://help.journeyfront.com/candidates/move-through-steps.md)
>
> Change Step, bulk moves and what candidates see when they move.

> [!TIP]
>
> Plan your steps around the decisions your team makes. A new step makes sense wherever you'd review candidates before letting them continue, for example between a quick screen and a longer assessment.

## Add activities to a step

With your steps in place, fill each one with the activities candidates complete there. Every type of activity is a block in the building blocks column, and you add one by dragging it into a step.

**1. Find the activity**

Find it in the building blocks, or type in **Search**. Your saved screening question and interview templates are under **Screening Questions** and **Interviews**: click **Templates** to show them (the number is how many you have), or search by name and matching templates show on their own. Click the eye icon next to a template to preview its questions before you add it. [Activities you can add](https://help.journeyfront.com/workflows/activities.md) lists every option.

**2. Drag it into a step**

Drag the block into the step, at the position where candidates should take it. An outlined slot shows where it will land.

![The New Typing Test building block being dragged from the building blocks into the Screening step, where the highlighted outlined slot shows where it will land](https://mintcdn.com/journeyfront/vQCJ8-ZVzF3DfqCc/images/workflows/build-a-workflow/workflow-add-activity.png?fit=max\&auto=format\&n=vQCJ8-ZVzF3DfqCc\&q=85\&s=0ddd580fc97bcd8de063d120adc14515)

**3. Set it up**

Click the activity to open its settings on the right. Change its name at the top, then finish its setup, such as its questions, instructions or the test to use. Each activity type's guide covers the details.

![The Customer Service Simulation activity selected in the Simulation step, with its settings highlighted on the right: its name at the top, Estimated Time (Minutes), Time Limit, the collapsed Instructions and Supporting Content sections marked Not added, and its questions with Add Question](https://mintcdn.com/journeyfront/vQCJ8-ZVzF3DfqCc/images/workflows/build-a-workflow/workflow-activity-settings.png?fit=max\&auto=format\&n=vQCJ8-ZVzF3DfqCc\&q=85\&s=b17fd3ebdf4359b750120c265709d78d)

Most activities have these settings:

* **Estimated Time (Minutes):** how long the activity takes. Offers and onboarding forms don't have one.
* **Time Limit** (screening questions only): turn it **On** and candidates have only the estimated time to finish the whole activity; anything unanswered when time runs out is submitted as not answered.
* **Instructions:** what candidates read before they start. **Supporting Content** (screening questions) is what they see while they answer, and interviews have **Instructions for Interviewer**. These sections start collapsed and show **Added** or **Not added**; click one to open it, and hover its info icon for a reminder of who sees it.
* **Questions** (screening questions and interviews): click **Add Question** to pick from your question library or **Create New Question**. Drag questions to reorder them.

For an interview, open **Interview Scheduler**, then **View and Edit Details** to set up scheduling. A newly added interview needs to be saved in your draft first. See [Set up an interview activity](https://help.journeyfront.com/interviews/interview-activity.md).

To **reorder** activities, drag them by their grip within a step or into another step. To **remove** one, click its trash can.

Candidates complete a step's activities in the order listed, unless the job req allows them to take activities out of order. See [Job settings](https://help.journeyfront.com/job-reqs/job-settings.md).

> [!TIP]
>
> Put quick, decisive activities first. Short screening questions before a longer assessment let candidates who aren't a fit find out fast, and keep everyone else moving.

## Save your changes

**1. Check the version name**

The title at the top is the version's name. A new version is named for you from the last one (**Workflow 2.0** becomes **Workflow 3.0**). Click it to rename it, like "Added typing test". Each version on the job req needs a different name.

![The top of the workflow editor with the title highlighted: the version name Workflow 3.0 with a pencil icon, and Workflow for Customer Care Associate with the job req's location and status underneath](https://mintcdn.com/journeyfront/vQCJ8-ZVzF3DfqCc/images/workflows/build-a-workflow/workflow-editor-title.png?fit=max\&auto=format\&n=vQCJ8-ZVzF3DfqCc\&q=85\&s=3655967e18c5f9d09daefcb0bea02b34)

**2. Save the draft**

Click **Save Draft**. Journeyfront saves your draft, confirms with a message, and you stay in the editor to keep working.

**3. Publish when you're ready**

Nothing changes for candidates until you publish. Click **Publish**; any unsaved changes are saved first. See [Publish workflow changes](https://help.journeyfront.com/workflows/publish.md).

To leave without saving, click **Exit**. If you have unsaved changes, Journeyfront asks whether to **Save Draft** or **Discard** them. To throw away a saved draft entirely, open the editor and click **Delete Draft**; this can't be undone.

## Get notified when an activity is completed

Each activity has a bell (**Notify Users**) on the Workflow page. Everyone on its list gets an email whenever a candidate completes that activity on this job req, so whoever reviews it, for example a skills test you check by hand, hears right away.

**1. Open the Workflow page**

Open the job req and go to **Setup**, then **Workflow**.

**2. Click the bell**

Click the bell (**Notify Users**) on the activity. The **Get Notified** window opens.

![The Workflow page with the bell icon highlighted on the Phone Screen activity in the Recruiter Interview step, next to its eye and lightning bolt icons](https://mintcdn.com/journeyfront/MP6XVW1Unu3e4opR/images/workflows/build-a-workflow/workflow-notify-bell.png?fit=max\&auto=format\&n=MP6XVW1Unu3e4opR\&q=85\&s=d3553af1730e5f573298e22efe03bccf)

**3. Choose who's notified**

Click **Notify Me** to add yourself, or **Add User** to search for someone else. Click the trash icon to take someone off the list. Changes save as you make them.

![The Get Notified window for the Phone Screen activity on the Customer Care Associate job req, with the Notify Me and Add User buttons and two users listed by name and email, each with a trash icon](https://mintcdn.com/journeyfront/MP6XVW1Unu3e4opR/images/workflows/build-a-workflow/workflow-get-notified.png?fit=max\&auto=format\&n=MP6XVW1Unu3e4opR\&q=85\&s=b7271e09c793418fb5764260a9b78d85)

> [!TIP]
>
> Notifications work best on activities your team acts on right away, like a final assessment or an interview. On a high-volume job req, a notification for every application adds up quickly.

To get an email when a candidate finishes their whole application instead, turn on **Candidate completes application** for yourself on the job req's hiring team.

> [card] [Hiring team](https://help.journeyfront.com/job-reqs/hiring-team.md)
>
> Who works on a job req, and the email when a candidate finishes applying.

## Preview what candidates see

On the Workflow page, click the eye icon (**Preview Activity**) on an activity. The preview opens on that activity.

* Use the **Previewing** menu to jump to any activity, or the arrows to move through them in order.
* Switch between the mobile, tablet and desktop views to check each screen size.
* Click **Back** to return to the Workflow page.

![The activity preview for the Customer Care Agent job req on the mobile view, with the Previewing menu open listing each step's activities, the arrows and screen size, and the mobile, tablet and desktop buttons](https://mintcdn.com/journeyfront/R_DAm8_xBTjPRKBw/images/workflows/build-a-workflow/gen-preview.png?fit=max\&auto=format\&n=R_DAm8_xBTjPRKBw\&q=85\&s=159ee2ca6cdfec50d942e304fabf9a67)

The preview shows screening questions, behavioral assessments, interviews and typing tests the way candidates see them. Language assessments from partners show a message that they can't be previewed, with a button to continue. Other activities, like offers and onboarding forms, don't have a candidate preview. Nothing you enter in the preview is saved.

> [!TIP]
>
> Before you start sending candidates to a new job req, preview it on the mobile view. Many high-volume candidates apply from a phone, so long instructions or wide tables are worth catching early.

## FAQ

> [accordion] Can I change the workflow after candidates have applied?
>
> Yes. Your changes stay in a draft until you publish them as a new version. Candidates already in progress stay on the version they started with, so their interviews and offers aren't affected. See [Publish workflow changes](https://help.journeyfront.com/workflows/publish.md).

> [accordion] Why don't I see the Setup tab on a job req?
>
> The Setup tab needs the *Manage Job Req Settings* permission. Ask your Journeyfront admin to check your security role.

> [accordion] Why can't I save my draft?
>
> Check the title at the top: the version needs a name that no other version on the job req uses. A note under the title tells you if the name is taken. A System Requirements Test also needs a requirement set chosen before the draft can be saved.

> [accordion] I removed something by mistake. Can I get it back?
>
> If you haven't saved yet, click **Exit** and choose **Discard** to throw away everything since your last save. Nothing reaches candidates until you publish, so the live version is never affected while you work.

> [accordion] Why isn't the skills test I need in the building blocks?
>
> **Skills Tests** lists the skills tests set up for your account. Ask your Customer Success Manager which skills tests are available for your roles. See [Skills tests](https://help.journeyfront.com/assessments/skills-tests.md).

> [accordion] How do candidates get to the next step?
>
> Your team moves them with **Change Step**, or an automation rule moves them when they meet the conditions you set. See [Move candidates through steps](https://help.journeyfront.com/candidates/move-through-steps.md) and [Automation rules](https://help.journeyfront.com/workflows/automation-rules.md).

> [accordion] What does Completed by mean?
>
> It shows who completes each activity: the interviewer for interviews, and the candidate for the others. A step's line shows everyone who completes its activities and their total estimated minutes.

> [accordion] Are my answers saved when I preview?
>
> No. The preview shows each activity as a candidate sees it, but nothing you enter is saved.

> [accordion] Can I copy a workflow from another job req?
>
> Yes, by duplicating the job req. The copy starts with the same steps, activities and automation rules, which you can then adjust. See [Create a job req](https://help.journeyfront.com/job-reqs/create.md).

## Related

> [card] [Activities you can add](https://help.journeyfront.com/workflows/activities.md)
>
> Every activity type and where to set it up.

> [card] [Publish workflow changes](https://help.journeyfront.com/workflows/publish.md)
>
> Take your draft live, now or on a date you choose.

> [card] [Automation rules](https://help.journeyfront.com/workflows/automation-rules.md)
>
> Move, message and route candidates automatically.

> [card] [Job settings](https://help.journeyfront.com/job-reqs/job-settings.md)
>
> Activity order, re-applying and other candidate experience settings.


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