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

# Language assessments

> Measure spoken and written language skills with Journeyfront's assessment partners, and track results by job req or across your company.

> [!NOTE]
>
> **Who can do this:** Users with the *Manage Job Req Settings* permission add a language assessment to a job req. Anyone who can open a Candidate Application can see the results. The company-wide **Language Assessment** dashboard needs *Company Dashboard Access*.
>
> **Availability:** Language assessments are an add-on that uses credits, from Journeyfront's partners Emmersion and Hallo. They appear in the workflow editor once a partner is turned on for your account. Ask your Customer Success Manager.

When a role depends on how well someone speaks, writes, reads or listens in a language, a language assessment gives you a standard, comparable result for every candidate. Candidates take the test as an activity in their application, and the results, including a CEFR level, land on their Candidate Application without anyone on your team having to run a call.

## What's measured

Results use the **CEFR** (Common European Framework of Reference for Languages), the global standard for describing language proficiency. It has six levels: A1 and A2 for beginners, B1 and B2 for intermediate, and C1 and C2 for proficient speakers. Each partner also gives its own score.

With Hallo, you choose the **Assessment Type** and the **Language** for each test:

| Assessment Type | What candidates do |
| - | - |
| **Speaking** | Answer out loud |
| **Writing** | Write responses |
| **Reading** | Read and answer questions |
| **Listening** | Listen and answer questions |
| **Speaking + Writing** | Both speaking and writing parts |
| **Comprehensive (Speaking, Writing, Reading & Listening)** | All four skills |

With Emmersion, you pick from the list of tests available to your account.

Each test uses add-on credits. See [Add-ons and credits](https://help.journeyfront.com/account-setup/add-ons.md) to check your balance.

## Add a language assessment to a job req

**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).

**2. Add the activity**

In the building blocks on the left, find your partner's group, **HALLO ASSESSMENT** or **EMMERSION ASSESSMENT**, and drag **New Hallo Assessment** or **New Emmersion Assessment** into the step where candidates should take it.

**3. Choose the test**

Click the activity to open its settings on the right. Under **Language Tests**, click **Add Language Test**.

* **Hallo:** in **Add Language Assessment**, choose an **Assessment Type** and a **Language**, click **Add**, then **Done**.
* **Emmersion:** in **Select Assessments to Add**, click **Add** next to a test, then **Close**.

**4. Check the scoring**

Each test lists what it measures, with score settings for this job req: which results earn which 1 to 5 score, and whether a result can knock a candidate out. Adjust them if this job needs a different bar.

**5. Save, then publish**

Set **Estimated Time (Minutes)** and click **Save Draft**; you stay in the editor. When you're ready for candidates to see it, click **Publish**. See [Publish workflow changes](https://help.journeyfront.com/workflows/publish.md).

![The workflow editor with a Hallo Assessment activity selected: New Hallo Assessment highlighted in the building blocks, the English Speaking test under Language Tests with its Speaking score settings, Add threshold and Add Language Test in the settings panel, and the Add Language Assessment window in front with Assessment Type Speaking, Language English, and the Add and Done buttons](https://mintcdn.com/journeyfront/V546gE5TModFe50b/images/assessments/language-assessments/gen-workflow-editor.png?fit=max\&auto=format\&n=V546gE5TModFe50b\&q=85\&s=b6a58cfea8bdb280d616e340cf27f3f1)

> [!TIP]
>
> Match the test to the job. A phone-based role needs speaking and listening; a chat or email role needs writing and reading. A Comprehensive test covers everything but takes candidates longer.

## What candidates see

* **The test opens from their application.** Hallo tests run inside the candidate's Journeyfront application. Emmersion tests take the candidate to Emmersion's site.
* **Device needs:** speaking tests need a microphone, and listening tests need speakers or headphones. Candidates may also be asked to allow camera access.

> [!TIP]
>
> Tell candidates ahead of time that they'll need a quiet place and a working microphone, and that their browser will ask for permission to use it.

## See a candidate's results

Open the candidate's Candidate Application and select the **Language** tab. It appears once the candidate has a language assessment. Depending on the partner, you'll see:

* An **overall score** and **CEFR** level, plus the partner's own score.
* Scores for each skill or part, such as fluency, grammar, pronunciation and vocabulary.
* A description of the candidate's level, and suggestions for what they can do to improve.
* The candidate's spoken and written responses to open questions, so you can listen and read for yourself.

The language assessment's score also appears on the **Score** and **Steps** tabs with the rest of the candidate's results.

![The Language tab of a Candidate Application for an English Speaking and Writing test: the overall CEFR level B2 with an explanation of CEFR, the Speaking and Writing levels, the Speaking part's score with Fluency, Grammar, Pronunciation and Vocabulary sub-scores, and What You Can Do To Improve](https://mintcdn.com/journeyfront/61dBaB1hIRAsZpUl/images/assessments/language-assessments/gen-language-tab.png?fit=max\&auto=format\&n=61dBaB1hIRAsZpUl\&q=85\&s=fca28a8ee9af35bce2f92dca942dd592)

### If the scores are missing

If the **Language** tab says the assessment is completed but scores are missing, click **Refresh Score** at the top of the tab to fetch them from the partner. If they still don't appear, contact Journeyfront support with a link to the Candidate Application.

## Language assessment dashboards

To see results across many candidates, use the **Language Assessment** dashboards:

* **For one job req:** open the job req, click the **Dashboard** tab, then **Language Assessment**. See [Job req dashboards](https://help.journeyfront.com/reporting/job-dashboards.md).
* **Across your company:** click **Dashboard** in the top navigation and choose **Language Assessment** from the dashboard menu. See [Dashboards overview](https://help.journeyfront.com/reporting/dashboards.md).

Each dashboard has two views. **Results Analysis** charts how many tests were taken, scores by partner, and how CEFR levels are spread, including how candidates at each level moved through your hiring process. **Language Results** lists every result, with the candidate, the step and activity where they took the test, the test name, their CEFR level and the partner's detailed scores. Use the **Controls** at the top to filter by dates, job req, step, test, candidate status, CEFR level or source.

> [!TIP]
>
> Use the **Language Results** view to compare CEFR levels with who you hired. If most of your hires sit at one level, that's a good guide for the score settings on your job reqs.

## FAQ

> [accordion] Why don't I see a language assessment in the workflow editor?
>
> No language assessment partner is turned on for your account yet. Language assessments are an add-on; ask your Customer Success Manager.

> [accordion] The candidate finished, but there are no results. What should I do?
>
> Results come from the partner. If the **Language** tab says the assessment is completed but scores are missing, click **Refresh Score**. If they still don't appear, contact support with a link to the Candidate Application.

> [accordion] Which languages can we test?
>
> It depends on the partner. With Hallo, the **Language** list in **Add Language Assessment** shows every language available for the assessment type you choose. With Emmersion, the test list shows what's available to your account.

> [accordion] Can a candidate retake a language assessment?
>
> Language assessment scores can't be deleted from the Candidate Application, so the usual retake option isn't available. Contact your Customer Success Manager if a candidate needs to take it again.

> [accordion] Does each test use a credit?
>
> Yes, language assessments use add-on credits. See [Add-ons and credits](https://help.journeyfront.com/account-setup/add-ons.md).

> [accordion] What does CEFR mean?
>
> The Common European Framework of Reference for Languages, the global standard for language proficiency. A1 and A2 are beginner levels, B1 and B2 intermediate, and C1 and C2 proficient.

## Related

> [card] [Add-ons and credits](https://help.journeyfront.com/account-setup/add-ons.md)
>
> Check your language assessment credits.

> [card] [Job req dashboards](https://help.journeyfront.com/reporting/job-dashboards.md)
>
> Language results for one job req.

> [card] [Dashboards overview](https://help.journeyfront.com/reporting/dashboards.md)
>
> Company-wide reporting, including language results.

> [card] [Assessments overview](https://help.journeyfront.com/assessments/overview.md)
>
> Every assessment and what candidates need.


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