> For the complete documentation index, see [llms.txt](https://helpdesk.ldtsoft.work/ldt-online-course/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpdesk.ldtsoft.work/ldt-online-course/quizzes-and-certificates/bulk-importing-quiz-questions-for-your-courses.md).

# Bulk Importing Quiz Questions for Your Courses

Import quiz questions from a CSV file instead of typing each one

This guide will show you how to quickly create a quiz with a large number of questions by uploading a single CSV file.

This is the fastest way to migrate an existing question bank from another system (like Google Forms, Word, or Excel) into your LDT course.

### Prerequisites

* **Course** and **Module** are already created: You have an available lesson within a module to add the quiz to. Follow [this guide to create your new course](https://helpdesk.ldtsoft.work/ldt-online-course)

### Step 1: Add a Quiz to Your Lesson

First, you need to create the quiz content block within your course lesson.

Navigate to your lesson: Go to **Courses** > Select your course > Select your module > Select or create a Lesson.

* **Add new content**: In the lesson, scroll down to the Contents section and click + Add new content.
* Select content type: Choose "**Quiz/tests**" from the list.
* Name your quiz: Enter a Content title.

<figure><img src="https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-31e499d20d8664165d4f4c75c6ef3093de537eb3%2Fcourse%207.1.png?alt=media" alt="Adding a Quiz / tests content block to the lesson"><figcaption></figcaption></figure>

<figure><img src="https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-93491efa1bdd44a9f5bbcd938ae28e405ad9bad0%2Fcourse%20a.1.png?alt=media" alt="The quiz block added with its title filled in"><figcaption></figcaption></figure>

### Step 2: Access the Bulk Import Feature

After adding the quiz content block, you'll find the option to import questions.

* Within the quiz setup interface, look for and click the **Add questions in bulk** button.
* A new window will appear with an Upload your csv file option and a Download sample csv link.

<figure><img src="https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-f5fad7bde3de1b03299ddcee350da6801f8845b9%2Fcourse%20a.2.png?alt=media" alt="Clicking Add questions in bulk inside the quiz"><figcaption></figcaption></figure>

<figure><img src="https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-5759b442b1c969d8c422cddf2a9a688b04f12558%2Fcourse%20a.3.png?alt=media" alt="The bulk import window with the CSV instructions"><figcaption></figcaption></figure>

### Step 3: Download the CSV Template and Fill in Your Questions

This is the most critical step. Follow these instructions precisely to avoid errors.

* **Download the template**: Click Download sample csv to get the template. ALWAYS use this template to ensure the correct format.
* **Fill in the information**: Populate the columns with your question data. The key columns are:
* **Question**: The text of your question.
* **Type**: The question type. Enter "Choice" for multiple-choice or "Essay" for a free-response question.
* **Explanation**: An optional explanation for the answer.
* **Answer**: The text of the answer choice.
* **Is Correct**: Mark whether an answer is correct. Enter "Yes" for the correct answer and "No" for incorrect ones.

<figure><img src="https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-b42ed969788d1fecfc7927a736f7e21b52ab7c3f%2Fcourse%20a.4.png?alt=media" alt="The filled CSV template with question, type, answer and correct columns"><figcaption></figcaption></figure>

### IMPORTANT RULES FOR FORMATTING THE CSV FILE:

* Multiple Choice Questions (Type: "Choice"):
* A single question will span MULTIPLE ROWS in the CSV file, with each row representing one answer option.
* The row containing the correct answer should have "Yes" in the "Is Correct" column.
* Essay Questions (Type: "Essay"):
* Only ONE ROW is needed for an essay question.
* The "Answer" and "Is Correct" columns can be left blank.

<figure><img src="https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-71911e387c944662817b35d2302df28b9c04b987%2Fcourse%20a.5.png?alt=media" alt="One row per essay question with the answer columns left empty"><figcaption></figcaption></figure>

### Step 4: Upload the CSV File

Once your CSV file is complete and saved, you can upload it.

* Go back to the import interface in LDT, click **Upload** your csv file, and select your file.
* The system will process and import all the questions directly into your quiz.

<figure><img src="https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-72129fcdf67d1af69e5d3b5dae827818025b2357%2Fcourse%20a.7.png?alt=media" alt="Uploading the CSV file and importing the questions"><figcaption></figcaption></figure>

### Step 5: Review and Configure Additional Settings

After importing, take a moment to review the quiz to ensure everything looks correct. You can also configure additional settings:

* **Display mode**: Choose between Slide (one question at a time) or Scrollable (all questions on one page).
* **Students must pass this quiz to complete the lesson**: Check this box to prevent students from progressing until they pass the quiz.
* **Maximum attempts**: Leave this field empty for unlimited retakes, or enter a specific number.
* **Allow students to view a results summary**: Check this to let students see their results after completion.

<br>