- 15 Aug 2025
- 5 minute read
- Print
- DarkLight
- PDF
Duolingo English Test Integration
- Updated 15 Aug 2025
- 5 minute read
- Print
- DarkLight
- PDF
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 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 or contact [email protected].
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.
Go to Database →Slate Template Library.
Add the Duolingo English Test (160-point scale) test type.
Select Save.
🔔 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:
Go to Database → Fields.
Select New Field.
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
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:
Go to Database → Source Format Library.
Add the Duolingo English Test source format. Duolingo will send you the remote server with your institution's unique API Key.
In the Duolingo English Test source format, select Edit.
Select the Import Automation tab.
In the Import Remote Server field, paste the full URL provided to you by Duolingo.
Select Save.
Select Edit Mappings.
Configure the remap settings for the format definition.
Once you are finished mapping the source format, return to the the source format overview page.
Select Edit.
Set the Remap Active setting to Active.
Select Save. The import runs using your remap settings for all files uploaded on or after the Remap As Of Date.
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.
Select Copy on your existing Duolingo English Test source format.
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.
Select Copy.
Select Edit.
Select the Import Automation tab.
Paste the additional URL provided by Duolingo in the Import Remote Server field.
Follow steps from the previous section to customize the Remap settings and activate the new source format.
📝 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 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:
Go to Database → Workflows.
Select an existing workflow, or create a new one.
Select the Reader Tabs tab.
Select Edit Reader Tabs (pencil icon).
Select Link.
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}}
.(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.
Select Save.
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:
Displaying Duolingo subscore information with a data container
To display Duolingo subscore information, configure an additional tab with a data container.
Go to Database → Workflows.
Select an existing workflow, or create a new one.
Select the Reader Tabs tab.
Select Edit Reader Tabs (pencil icon).
Select Materials from the palette.
Configure the following settings:
Status: Active
Name: Enter a name for the tab.
Filters: Add filters as necessary.
Select Save.
Select the tab you just created.
Select the Edit Materials icon.
Select Data Container from the palette.
From the Object Type list, select Test Scores.
Select Continue.
From the Template list, select Auto PDF.
Select the Page Builder tab.
Enter a page title.
Select Filter.
From the Test group, select Type.
Select Continue.
Select Duolingo English Test (160-point scale).
Select Save.
Select Export.
Select Test Date, Overall Score, and subscores.
Select Save.
The resulting data container:
Translation codes
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. |