Add a quiz to a track
Increase the efficiency of your learners.
This guide explains how to add a quiz to a track from Web UI and Instruqt CLI.
A quiz is a multiple-choice question the learner must answer during track play before proceeding to the next challenge or finishing the track. Quizzes help learners to:
  • Motivate to learn.
  • Remember what was learned.
  • Assess what was learned.
Each quiz needs at least two possible answers and you can assign one or more answers as correct.

Before you begin

You must have already built a track to which you can add a quiz. Follow the guide Create a track from a template if needed.

Add a quiz

Pick the Web UI or the Instruqt CLI route depending on your preference:
🌐 Web UI
💻 Instruqt CLI
  1. 1.
    Open your browser and go to play.instruqt.com. ↳ Instruqt shows your content.
  2. 2.
    Click the TRACK_NAME of the track you want to add a quiz to. ↳ Instruqt shows the corresponding Track overview page.
  3. 3.
    Click Add challenge as a quiz is a special type of challenge.
  4. 4.
    In the Title field, enter your title for the quiz—for example, Elon's enigma.
  5. 5.
    In the Slug field, enter your slug—for example, elon-enigma.
  6. 6.
    In the Type list, select Quiz. ↳ Down the bottom, Instruqt shows the Quiz answers heading and a New answer button.
  7. 7.
    In the Editor tab, enter your assignment text in Markdown. For example:
    1
    What is the next company Elon will buy?
    Copied!
  8. 8.
    Click New answer to create the first possible answer.
  9. 9.
    In the Answer field, enter your answer description—for example, Jira.
  10. 10.
    Select the Correct answer checkbox to set the answer as correct. Leave the checkbox unchecked to set the answer as wrong. For now, leave it unchecked.
  11. 11.
    Click New answer and add Meta as the right answer.
  12. 12.
    Click New answer again and add Instruqt as a wrong answer.
  13. 13.
    Click Save to add the quiz. ↳ Instruqt shows the Track overview page again.
  14. 14.
    Click Start track and test the newly added quiz.
A quiz is a special type of challenge, so you will add a challenge to your track and transform this challenge into a quiz.
  1. 1.
    Open a terminal and activate your track directory:
    1
    cd DIRECTORY_NAME
    Copied!
    ⇨ Replace DIRECTORY_NAME with your track directory.
  2. 2.
    Add a challenge to the track
    1
    instruqt challenge create --title "CHALLENGE_TITLE"
    Copied!
    ⇨ Replace CHALLENGE_TITLE with your title—for example, Elon's enigma.
  3. 3.
    Open the assignment.md file of the newly created challenge in your code editor and replace its content with the following:
    1
    slug: elon-enigma
    2
    type: quiz
    3
    title: Elon's enigma
    4
    teaser: Elon's enigma
    5
    answers:
    6
    - Jira
    7
    - Meta
    8
    - Instruqt
    9
    solution:
    10
    - 2
    11
    difficulty: basic
    12
    timelimit: 600
    13
    ---
    14
    What is the next company Elon will buy?
    Copied!
  4. 4.
    Save the assignment.md file and move back to Instruqt CLI to deploy the updated track:
  5. 5.
    1
    instruqt track push
    Copied!
  6. 6.
    Now open your browser and go to play.instruqt.com.
  7. 7.
    Click the TRACK_NAME of the track you added a quiz to. ↳ Instruqt shows the corresponding Track overview page, including the newly added quiz.
  8. 8.
    Click Start track and test the quiz.
Great job! Your tracks keep getting better and better. How about adding a script to check challenge execution to go even further?
Copy link
Edit on GitHub