Import and Export

If you already have existing quiz questions, you can easily import them using a TXT or CSV file. TXT (plain text) allows you to write questions in any text editor, following some basic rules (see below). CSV file can be created using any spreadsheet processor, such as Microsoft Excel or Google Sheets. Faabul also allows you to import and export complete presentations in a JSON format.

To import a quiz, go to My quizzes and choose Import from the menu. The imported quiz will appear among your quizzes.

To export a quiz, open the quiz and choose Share from the menu, then switch to Export tab.

The following formats are currently supported:

  • JSON (import and export)
  • TXT (plain text, import only)
  • CSV (comma separated values, import only)

Exporting and importing quizzes in JSON

JSON format is primarily used for transferring quizzes from one account to another. The quiz will look the same under the new account.

Important: Uploaded media used in the quiz will still point to the user space of the original account. In case the original account gets deleted in future (e.g. per the original account holder request), these media will eventually cease to work and must be replaced.

Importing plain text quizzes

You can import both multiple choice and text questions from a plain text file. Make sure that it adheres to the following template:

{multiple choice question}
A) {option}
B) {option}
C) {option}
D) {option}
Correct answer: B) {optional explanation}

{text question}
Correct answer: {correct answer}
Explanation: {optional explanation}

...

Note that the questions are separated by an empty line. Explanation is optional and can be either inline (in case of MCQ) or on a separate line as shown above.

This sample will import one MCQ and 1 text question:

Who invented the steam engine?
A) Leonardo da Vinci
B) Thomas Edison
C) James Watt
D) Isaac Newton
Correct answer: C) James Watt. James Watt invented the steam engine in 1765, which paved the way for the Industrial Revolution.

Who invented the light bulb?
Correct answer: Thomas Edison
Explanation: Thomas Edison invented the light bulb in 1879, which revolutionized the way we light our homes and buildings.

Importing quizzes from a CSV file

You can import both multiple choice and text questions from a CSV file. Make sure the file contents adheres to these rules:

  • the first row contains a header (column names)

  • separator is a comma (,), a semicolon (;) or a tab ( )

  • following columns are present:

    • title (optional, used as slide title)
    • question
    • explanation (optional)
    • correct (reference to the correct options(s). Use on of the following: A,B,C,D... OR repeat the correct option text. If multiple options are correct, use | as a separator)
    • option1 .. optionN (all MCQ answer options - to use less options for some of the questions, just leave field blank)
    • content If present, the question is treated as a fill-in question.
  • for multiple choice questions, the correct field is a reference to the correct option(s). Use either A,B,C,D... OR repeat the correct option text. If multiple options are correct, use | as a separator.

  • for text questions, the correct field contains the correct answer text. If multiple answers are correct, use | as a separator - e.g. truck|lorry.

  • for fill-in questions, the content field contains the content of the question, e.g. "Number 1 is {{*odd|even}} whereas number 2 is {{odd|*even}}.".

  • option1 .. optionN are only relevant to MCQs and contain all other options. Must be empty (or not present) for text questions

question,explanation,correct,option1,option2,option3,option4
Who was the first human to go into space?,"He orbited the Earth once in his Vostok 1 spacecraft on April 12, 1961",A,Yuri Gagarin,Neil Armstrong,John Glenn,
question,explanation,correct
What planet is known as the **Red Planet**?,"Mars is known as the **Red Planet** due to its reddish appearance in the night sky, which is caused by iron oxide (rust) on its surface.",Mars
question,explanation,content
Fill in the blanks:,Ammonia (NH3),Ammonia consist of one atom of {{carbon|*nitrogen|sulphur}} and three atoms of {{carbon|*hydrogen|oxygen}}.

Note on the second line that quotes are used to enclose the explanation text, which contains a comma.