---
title: "Duolingo English Test Integration"
slug: "duolingo-english-test-integration"
updated: 2026-06-05T18:26:00Z
published: 2026-06-05T18:26:00Z
canonical: "knowledge.technolutions.net/duolingo-english-test-integration"
---

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

# Duolingo English Test Integration

The **Duolingo English Test**is a convenient and affordable online English proficiency assessment developed by Duolingo. The test results include a proficiency score, subscores, and an unscored video interview and writing sample, which can be integrated into the Slate Reader. The [scores](https://englishtest.duolingo.com/scores) are comparable to other major English proficiency tests, including TOEFL and IELTS.

Each test session is certified by a remote human proctor with the help of artificial intelligence, which examines recordings of the student, computer screen, microphone, keystrokes, and mouse movements to ensure they have not violated any of the test rules.

## Receiving Duolingo English Test results in Slate

It is free to accept Duolingo English Test results. If your institution is interested in accepting the Duolingo English Test, visit [Duolingo English Test for Universities](https://englishtest.duolingo.com/edu) or contact [institutional@duolingo.com](mailto:institutional@duolingo.com).

Duolingo English Test scores and video endpoints can be imported into Slate using an API call that is configured as a source format.

A Reader Tab can also be configured to display the Duolingo English Test certificate and video. Perform the steps illustrated below to configure integration with Duolingo.

## Step 1: Adding the Duolingo English Test Types

The test type stores the score results. The 160-point scale accommodates scores for tests taken on or after July 15, 2019.

1. Go to **Database**→ **Suitcase.**
2. Select **Import.**
3. Paste the following Suitcase ID:

```SuitcaseID
0af5b99f-8289-4d56-acf9-84f710f2d62d:slate-examples
```
4. Select **Import.**

> [!CAUTION]
> 🔔 Important!
> 
> Do not make changes to the test type.

## Step 2: Creating the Duolingo embed URL custom field

Use a custom field to store the embed URL.

This URL can be included on a Reader Tab so that Readers can view the test score, test date, and also view the video recording of the speaking portion of the test. See below about configuring a Reader Tab to display this.

To create this custom field:

1. Go to **Database** → **Fields**.
2. Select **New Field**.
3. Configure the following settings:
  - **Status:** Active
  - **Scope Category:**Records
  - **Scope:**Person
  - **ID:**`duolingo`
  - **Name:**Duolingo Embed URL
  - **Field Type:**Free Text
  - **Unique for Merging:**Do not use value for merging ![](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/image(764).png)
4. Select **Save.**

## Step 3: Adding the Duolingo English Test source format

This source format automatically fetches score results shared with your institution.

To add the source format to your database:

1. Go to **Database** → **Source Format Library**.
2. Search for **Duolingo**.
3. Add the **Duolingo English Test**source format.
4. In the Duolingo English Test source format, select **Edit.**
5. Select the **Import Automation tab.**
6. In the **Import Remote Server**field, paste the full URL provided to you by Duolingo.
  - Duolingo will provide you with the remote server with your institution's unique API Key.
  - The URL must be **exactly**what is supplied by Duolingo.
  - If a colleague has provided this URL to you over certain chat platforms (such as Slack), the end of the URL might become corrupted.
  - The URL **must** end with this string of characters: `?min_datetime={{dtstart|date:'s'}}&max_datetime={{dtend|date:'s'}}`

[![](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/360038903291.png)](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/360038903291.png)
7. Select **Save.**
8. Select **Edit Mappings.**
9. Configure the remap settings for the format definition.
  - Many items are pre-mapped. Feel free to customize how the data will be imported.
  - Map the custom field you created earlier. Select **Unsafe Override** to ensure records with active applications have this field set by this source format.

[![](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/360038903191.png)](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/360038903191.png)
10. Once you are finished mapping the source format, return to the the source format overview page.
11. Select **Edit.**
12. Set the **Remap Active** setting to **Active**.
13. Select **Save.**The import runs using your remap settings for all files uploaded on or after the **Remap As Of Date**.

## **Optional: Overriding the last remote server fetch**

Overriding this value will limit the fetch to just those since the last import.

1. To the right of the **Last Remote Server Fetch (UTC)**field, select **Override.**
2. Enter the case-sensitive confirmation message.
3. Select **OK.**
4. In the **Last Remote Server Fetch (UTC) field**, enter the approximate timestamp, in the format `yyyy-MM-ddTHH:mm:ss` (for example, `2023-04-05T03:22:30`), that the source format should send to EDMTOEFL to restrict the data retrieved during the first data fetch.

[![Last_Remote_Server_Fetch.png](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/15471263781787.png)](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/15471263781787.png)
5. Select **Save.**

### Handling multiple Duolingo accounts

If your institution has multiple Duolingo accounts, additional copies of the Duolingo English Test source format can be used to fetch the data for the additional accounts.

1. Select **Copy** on your existing Duolingo English Test source format.

[![mceclip0.png](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/4422463050779.png)](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/4422463050779.png)
2. Select **Copy Remap Settings**. Do not change the **Name**or **Format**settings of the source format. These two settings allow the source format to inherit settings from the standard source format, so changing these settings prevents the data from importing successfully.[![](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/360038918912.png)](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/360038918912.png)
3. Select **Copy**.
4. Select **Edit.**
5. Select the **Import Automation tab**.
6. Paste the additional URL provided by Duolingo in the **Import Remote Server** field.
7. Follow steps from the previous section to customize the **Remap** settings and activate the new source format.

> [!WARNING]
> **📝**Note
> 
> While editing the **Name** and **Format** settings of the source format prevent the source format from inheriting the settings from the standard source format, the notes on the different source formats can be edited individually.

## Step 4: Creating Workflow Reader tabs

[Workflow Reader tabs](/v1/docs/workflows#reader-tabs) let application readers view test scores, test dates, and watch video recordings of the spoken part of the test. A second tab can display Duolingo subscores.

To create a workflow Reader tab for the Duolingo English Test:

1. Go to **Database** → **Workflows**.
2. Select an existing workflow, or [create a new one](/v1/docs/workflows).
3. Select the **Reader Tabs** tab.
4. Select **Edit Reader Tabs**(pencil icon).
5. Select **Link**.
6. Configure the following settings:
  - **Status:**Active
  - **Name:**Enter a name for the Reader tab. For example, *Duolingo*.
  - **URL Type:**URL
  - **URL:**Enter URL to be the **merge field** for the custom field you made above. For example, `{{duolingo}}`. ![](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/Screenshot 2025-07-16 at 3.07.08 PM.png)
  - **(Optional) Filters:**If you want the tab to only appear if the applicant has a value in the **Duolingo Embed URL** field:
    - Add a join to Application
    - Add a second join to *Person*.
    - Create a subquery filter that looks for the existence of the url by adding a Person export for **Duolingo Embed URL**.![](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/Screenshot 2025-07-16 at 3.08.11 PM(1).png)
7. Select **Save.**
8. Drag the tab to where you’d like it to appear in the order of tabs.

Applications with the Duolingo embed URL field will now feature a Reader tab with their embedded video and certificate:

![](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/image(760).png)

### Displaying Duolingo subscore information with a data container

To display Duolingo subscore information, configure an additional tab with a [data container](/v1/docs/data-containers).

1. Go to **Database** → **Workflows**.
2. Select an existing workflow, or [create a new one](/v1/docs/workflows).
3. Select the **Reader Tabs** tab.
4. Select **Edit Reader Tabs**(pencil icon).
5. Select **Materials**from the palette.
6. Configure the following settings:
  - **Status:**Active
  - **Name:**Enter a name for the tab.
  - **Filters:**Add filters as necessary.
7. Select **Save.**
8. Select the tab you just created.
9. Select the **Edit Materials** icon.![](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/image(768).png)
10. Select **Data Container**from the palette.

![](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/image(770).png)
11. From the **Object Type**list, select **Test Scores.**
12. Select **Continue.**
13. From the **Template**list, select **Auto PDF.**
14. Select the **Page Builder** tab.
15. Enter a page title.
16. Select **Filter**.
17. From the Test group, select **Type.**
18. Select **Continue.**
19. Select **Duolingo English Test (160-point scale).**
20. Select **Save.**
21. Select **Edit**for the Data Container (pencil icon).
22. Select the **Page Builder** tab.
23. Select **Export.**
24. Select **Test Date, Total Score,**and **subscores.** ![](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/image(773).png)
25. Select **Save.**

The resulting data container:

![](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/image(761).png)

## Translation codes

[Translation codes](/v1/docs/fields-and-prompts-translation-codes) let you take any value and change it to something else.

The Duolingo English Test is comparable to both TOEFL and IELTs. The concordance tables are available in the **Slate Template Library** as **Translation Codes**.

| Translation Code | Description |
| --- | --- |
| **Duolingo-TOEFL** | Converts the Duolingo English Test (100-point scale) to TOEFL scores using the concordance table. |
| **Duolingo-IELTS** | Converts the Duolingo English Test (100-point scale) to IELTS scores using the concordance table. |
| **Duolingo160-TOEFL** | Converts the Duolingo English Test (160-point scale) to TOEFL scores using the concordance table. |
| **Duolingo160-IELTS** | Converts the Duolingo English Test (160-point scale) to IELTS scores using the concordance table. |