Comment on page

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 ↳ 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 dashboard page.
  3. 3.
    In the Challenges section, click Add new as a quiz is a special type of challenge.
  4. 4.
    In the Name field, enter your name for the quiz—for example, The Ultimate Question.
  5. 5.
    In the URL field, enter your URL—for example, ultimate-question.
  6. 6.
    Pick the Multiple choice challenge type.
  7. 7.
    Click Save. ↳ The New challenge pop-up closes.
  8. 8.
    In the Challenges section, click your newly created challenge. ↳ The Edit challenge page opens.
  9. 9.
    Click Quiz.
  10. 10.
    In the Question field, enter your question text in Markdown. For example:
    What's the Answer to the Ultimate Question of Life,
    The Universe, and Everything?
  11. 11.
    Click Add answer to create the first possible answer.
  12. 12.
    In the Answer option field, enter your answer description—for example, Self-realization.
  13. 13.
    Select the This is a correct answer checkbox to set the answer as correct. Leave the checkbox unchecked to set the answer as wrong. For now, leave it unchecked.
  14. 14.
    Click Add answer and add 42 as the right answer.
  15. 15.
    Click Add answer again and add Cosmic unity as a wrong answer.
  16. 16.
    Click Save changes, followed by Back to track. ↳ Instruqt shows the Track dashboard page again.
  17. 17.
    Click Play 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:
    ⇨ Replace DIRECTORY_NAME with your track directory.
  2. 2.
    Add a challenge to the track
    instruqt challenge create --title "CHALLENGE_TITLE"
    ⇨ Replace CHALLENGE_TITLE with your title—for example, Elon's enigma.
  3. 3.
    Open the file of the newly created challenge in your code editor and replace its content with the following:
    slug: elon-enigma
    type: quiz
    title: Elon's enigma
    teaser: Elon's enigma
    - Jira
    - Meta
    - Instruqt
    - 2
    difficulty: basic
    timelimit: 600
    What is the next company Elon will buy?
  4. 4.
    Save the file and move back to Instruqt CLI to deploy the updated track:
  5. 5.
    instruqt track push
  6. 6.
    Now open your browser and go to
  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?