> For the complete documentation index, see [llms.txt](https://help.timelygrader.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.timelygrader.ai/d2l-support-articles/quizzes-d2l/importing-a-quiz.md).
# Importing a Quiz
Bring a quiz across from D2L, choose how it’s graded, and map criteria to its written questions.
Quizzes aren’t created in TimelyGrader; they’re imported from D2L Brightspace. Only the essay/written (subjective) questions come to TimelyGrader for rubric grading. Multiple choice and other auto-graded questions stay with D2L, which has already scored them. TimelyGrader shows them for reference, so the total on screen matches your gradebook.
Importing takes three steps: **Quiz Overview**, **Grading & Feedback Settings** and **Questions**.
{% hint style="info" %}
The quiz and its questions come across when you import it. Students’ attempts don’t: Brightspace doesn’t let TimelyGrader import quiz submissions, so once students have submitted you upload them as a CSV. See [Uploading Quiz Attempts](/d2l-support-articles/quizzes-d2l/importing-quiz-attempts.md).
{% endhint %}
{% hint style="info" %}
Nothing is created until you click **Save** on the last step. You can leave the import at any point without leaving a half-made quiz behind, and **Back** returns to the previous step without losing your choices.
{% endhint %}
## Choosing the quiz
{% stepper %}
{% step %}
### Open Quizzes
In the sidebar, click **Quizzes**, then click **Import** in the top right corner.
{% endstep %}
{% step %}
### Select the quiz
The **Select a Quiz to Import** dialog opens. Open the **Quiz Name** list, choose the D2L quiz you want to grade, and click **Import**. **Import** stays disabled until you choose a quiz, and closing the dialog creates nothing.
The import then opens on its first step, **Quiz Overview**.
{% endstep %}
{% endstepper %}
## Step 1: Quiz Overview
{% stepper %}
{% step %}
### Check the question split
The first step lists every question with its point value. The summary line shows how many questions there are, how many are graded on TimelyGrader and how many are graded on D2L, with the **Total Score** beneath.
* **Subjective Questions** are the written-response (essay response) questions TimelyGrader will grade.
* **Auto-Graded Questions** are already scored by D2L. They’re shown for reference; TimelyGrader doesn’t regrade them.
The split follows the question types in D2L and can’t be changed here. Click **Next**.
{% endstep %}
{% endstepper %}
## Step 2: Grading & Feedback Settings
{% stepper %}
{% step %}
### Check the quiz rubric
The **Quiz Rubric** comes across with the quiz and can’t be edited during the import. To change it now, make the changes in D2L and import the quiz again. Once the quiz is imported you can also edit the rubric for this quiz in TimelyGrader; see [Editing a Quiz’s Rubric and Questions](/d2l-support-articles/quizzes-d2l/quiz-rubric-and-questions.md).
{% hint style="success" %} **Hugo’s tip:** Click **Expand all criteria** to see every rating and its points before you commit.
{% endhint %}
{% endstep %}
{% step %}
### Choose the Rubric Type
* **Holistic Rubric:** one rubric applies across all questions in this quiz. It suits a quiz where every question probes the same skill, or a quiz built around one essay question.
* **Question-By-Question Rubric:** each question uses its own criterion from the rubric, with its own evidence. It grades more consistently when the questions test different things.
{% endstep %}
{% step %}
### If Question-By-Question Rubric is selected, you will also need to choose the Quiz Type
* **Interdependent Questions:** later questions build on earlier answers, so TimelyGrader reads the full attempt before grading any one question.
* **Standalone Questions:** each question is graded independently, using only that question’s own response.
{% endstep %}
{% step %}
### Map criteria to questions
With a question-by-question rubric, each criterion needs a question to grade. **Map criteria by order automatically** is on by default: it matches each question to a criterion based on their order in the quiz and the rubric, and each criterion shows its question with **Mapped by order**.
If the order doesn’t line up, untick it. Each criterion then shows **Grades question** with a button for every written question; click the one it grades. A criterion grades one question, but a question can have several criteria. A criterion without a question reads **Not assigned yet**.
A holistic rubric skips mapping entirely. Click **Next**.
{% hint style="warning" %}
If a criterion and a question don’t line up, the mismatch must be resolved before student submissions can be uploaded.
{% endhint %}
{% endstep %}
{% endstepper %}
## Step 3: Questions
{% stepper %}
{% step %}
### Check each question’s criteria
The last step lists the **Subjective Questions**; use the **Q1**, **Q2** buttons to jump between them. With a question-by-question rubric, each question has a **Criterion** list showing the criteria that grade it. Open the list to add or remove one, or click the bin next to a criterion to remove it. Changing the mapping by hand turns off mapping by order.
A question without a criterion reads **None assigned yet — this question cannot be graded until one is.**
{% endstep %}
{% step %}
### Add grading notes
Each question has a **Grading Notes** field for what the AI should look for in an answer to that question. Write what a strong answer contains, in the terms you’d use marking by hand. Notes are optional; a question without notes is graded from the rubric alone.
{% hint style="success" %} **Hugo’s tip:** If the rubric doesn’t spell out how points are earned, put the point scale in the grading notes, along with clear criteria for how students earn or lose points.
{% endhint %}
{% endstep %}
{% endstepper %}
## Saving the quiz
{% stepper %}
{% step %}
### Click Save
Click **Save** in the top right corner. The **Sync Rubric To Your LMS?** dialog opens.
{% endstep %}
{% step %}
### Decide whether to sync the rubric
Tick **Sync TimelyGrader rubric to LMS** to send the rubric to D2L. It replaces the quiz’s existing rubric in D2L, or is added if there isn’t one. The button then reads **Sync**; with the box unticked it reads **Skip**.
{% hint style="warning" %}
If you don’t sync the rubric, only the overall final grade is passed back to D2L for each student and feedback will go back to the overall comments box.
{% endhint %}
{% endstep %}
{% step %}
### Finish
A confirmation appears: **Rubric Synced Successfully** if you synced, or **Your quiz was saved successfully** if you skipped. Click **Ok** to return to the Quizzes page.
{% hint style="info" %}
The new quiz is a draft, so students can’t see it until you publish it from the quiz page header. See [Managing Quizzes](/d2l-support-articles/quizzes-d2l/publishing-a-quiz.md).
{% endhint %}
{% endstep %}
{% endstepper %}
## FAQ
Why don’t students’ attempts come across automatically?
Brightspace doesn’t let TimelyGrader import quiz submissions. You export them from Brightspace as a CSV and upload them instead. See [Uploading Quiz Attempts](/d2l-support-articles/quizzes-d2l/importing-quiz-attempts.md).
A question I expected isn’t under Subjective Questions.
Only written responses come to TimelyGrader. Auto-graded question types stay with D2L, which has already scored them, and appear under Auto-Graded Questions.
Can I choose which questions TimelyGrader grades?
No. The split follows the question types in D2L.
Does importing change the quiz in D2L?
Importing reads the quiz. The only thing it can write to D2L is the rubric, and only if you tick Sync TimelyGrader rubric to LMS when you save.
What happens if TimelyGrader can’t reach D2L during the import?
Nothing is created. The step keeps what you’ve entered and you can try again.
## Related articles
* [Editing a Quiz’s Rubric and Questions](/d2l-support-articles/quizzes-d2l/quiz-rubric-and-questions.md)
* [Managing Quizzes](/d2l-support-articles/quizzes-d2l/publishing-a-quiz.md)
* [Uploading Quiz Attempts](/d2l-support-articles/quizzes-d2l/importing-quiz-attempts.md)
**Hugo’s tip:** Click **Expand all criteria** to see every rating and its points before you commit.
{% endhint %}
{% endstep %}
{% step %}
### Choose the Rubric Type
* **Holistic Rubric:** one rubric applies across all questions in this quiz. It suits a quiz where every question probes the same skill, or a quiz built around one essay question.
* **Question-By-Question Rubric:** each question uses its own criterion from the rubric, with its own evidence. It grades more consistently when the questions test different things.
{% endstep %}
{% step %}
### If Question-By-Question Rubric is selected, you will also need to choose the Quiz Type
* **Interdependent Questions:** later questions build on earlier answers, so TimelyGrader reads the full attempt before grading any one question.
* **Standalone Questions:** each question is graded independently, using only that question’s own response.
{% endstep %}
{% step %}
