QTI Import and Export in Learnly Assessments
QTI (Question and Test Interoperability) is a standard format for transferring assessment questions between compatible learning platforms and assessment tools.
Learnly supports QTI 1.2, QTI 2.1, and QTI 3.0 imports, and exports assessments in QTI 2.1 format.
Where to Find QTI Import/Export
Go to Training Studio → Assessments.
Open the assessment you want to work with.
Click the QTI Import/Export tab.
Shortcut: From the Assessments page, click the ⋮ menu on an assessment card and select 'QTI Import/Export'.
Import a QTI Package
You can import questions from a supported QTI package into an existing Learnly assessment.
Step 1: Select the QTI File
On the 'QTI Import/Export' tab, click 'Select QTI File' and choose the QTI package you want to import.
Step 2: Start the Import
After selecting the file, the button changes to 'Import <file name>'. Click the button to start the import.
Step 3: Review the Import
Depending on the contents of the QTI package, Learnly may show a review step before importing the questions.
A review step appears when:
The package contains 'topic tags' that need to be mapped to Learnly Categories.
The same QTI package was previously imported into the assessment.
If a review step appears, review the information and click 'Import N questions' to continue.
If no review is required, Learnly continues with the import automatically.
Step 4: Check the Import Summary
After the import finishes, Learnly displays a summary of the results.
Depending on the outcome, you may see:
Green: Import complete
Yellow: Import finished with skipped items
Red: Import failed
Warnings: Some metadata needs attention, but valid questions can still be imported
For example, a package may contain questions as well as unsupported intro or outro screens. These unsupported items are skipped while the supported questions are imported.
From the summary, you can:
Click Review imported questions to review and publish the imported questions.
Click Categorize N questions to assign Categories to imported questions.
You can also check the Recent Jobs section to see whether an import completed or failed.
Imported Questions Are Unpublished
Imported questions are added as 'Unpublished'.
- This means learners cannot see the imported questions until you publish them, even if the assessment itself is already published.
- Importing questions does not change the assessment's own Published or Draft status.
- After importing, review the questions and publish them from the Questions tab.
- For more information, see Reviewing and Publishing Assessment Questions.
Importing the Same QTI Package Again
If you try to import a QTI package that was already imported into the same assessment, Learnly displays a warning before adding the questions again.
The warning includes the date of the previous import.
Step 5: Download the Package
Your browser downloads the QTI package as a .zip file.
You can use the exported package with another QTI-compatible LMS or assessment tool.
If an Import Fails
If an import fails, Learnly does not save any questions from that package.
You can safely try the import again.
If your connection drops during the process but the import actually completed, Learnly returns the existing result instead of adding the questions twice.
QTI File Requirements
| Requirement | Details |
|---|---|
| File type | .zip only. If you have a single .xml file, add it to a ZIP file before importing. |
| Maximum size | Your Learnly administrator sets the maximum package size and can raise the limit if needed. |
| Upload method | Upload the package through Select QTI File so Learnly can scan it for malware. |
| Who can import | Org admins, team managers, and authors |
Supported Question Types
Learnly converts supported QTI question types into the corresponding Learnly question types.
| QTI Question Type | Learnly Question Type | What's Imported |
|---|---|---|
| Choice, one answer | Multiple Choice | Question, choices, correct answer, and feedback as the explanation |
| Choice, several answers | Multiple Answer | Question, choices, correct answers, and feedback |
| True/false | Multiple Choice | Question, two options, and correct answer |
| Inline choice | Dropdown | Question, options, and correct option |
| Text entry | Free Text | Question only |
| Extended text | Essay | Question only |
For Free Text and Essay questions, you may need to add additional settings after import. For example, add accepted keywords to Free Text questions or a rubric to Essay questions.
Troubleshooting
| What you see | What to do |
|---|---|
| "Please select a QTI package (.zip file)" | Make sure the file is a .zip package. If you have an XML file, add it to a ZIP file before importing. |
| "Upload failed" or "Package is too large" | Check your connection and contact your Learnly administrator if you need the package size limit increased. |
| "Upload the QTI package through Learnly before importing it" | Select the file again using Select QTI File so Learnly can scan the package. |
| "This package was not scanned by Learnly" | Select and upload the package again through Select QTI File. |
| "QTI package has too many files" or "expands beyond the allowed size" | Split the package into smaller QTI packages and import them separately. |
| The malware scan rejects the file | The package was blocked for safety. Export the package again from the source system. If the issue continues, contact support. |
| "No questions were imported" | Check the import summary to see whether the package contains unsupported question types. |
| "No valid QTI assessment item found" | Make sure you're importing a QTI package rather than another package format such as SCORM or Common Cartridge. |
| Imported questions don't have answer options or a correct answer | Free Text and Essay questions are imported as question text only. Complete the question in the Learnly editor before publishing. |
| Questions appear as "Uncategorized" | Assign Categories to the imported questions. See Organizing Assessment Questions by Category. |
| Any other error | Copy the message shown in the error box and contact support with the QTI package. |
Frequently Asked Questions
Can I import questions into a new assessment directly from the Assessments page?
No. Create the assessment first, then open its QTI Import/Export tab and import the package.
You can also use the ⋮ menu on an assessment card to go directly to QTI Import/Export.
Are imported questions graded like questions created in Learnly?
Yes. After import, supported questions become regular Learnly assessment questions.
Does Learnly support adaptive (CAT) QTI tests?
Learnly imports the supported questions from a CAT package, but the adaptive rules aren't imported. Learners take the imported questions as a standard assessment.
Can I import the same QTI package twice?
Yes. Learnly warns you if the package was previously imported into the same assessment. You can choose to import the questions again.
Are learner results included when I export an assessment?
No. QTI exports contain assessment questions and supported question metadata, not learner results. Use Reports to view learner results.
