User Guide

If we did our job well, you will never need a user guide

Ideally, if we did our job well, you would never have to visit this page. But since you are here, something must have went wrong. This user guide will provide you with some unambiguous recommendation to fix your problem.

GETMARKED Digitaliser allows you to import any kind of quiz in one-click as long as the document was prepared for classroom use in mind. Your quiz do not need to be formatted in any specific way, we will intelligently infer what's inside.

Here's some sample Word document quizzes to give you a sense of the variety of questions we can convert: We support much much more formats and more are added everyday as our AI gets more intelligent.
Supported Question Types, LMS and File Formats
Supported Question types
  1. True-false question
  2. Multiple choice question
  3. Multiple response question
  4. Cloze question
  5. Cloze question
    (select dropdown menu)
  6. Open-ended question
  7. Matching question
  8. Likert question
Supported Platforms
  1. Canvas
  2. Blackboard
  3. Moodle
  4. Brightspace
  5. Schoology
  6. NEO LMS
  7. LMS365
  8. Sakai
  9. Google Classroom/Forms
  10. Microsoft Forms
  11. itslearning
  12. TalentLMS
  13. Adobe Captivate
  14. LumiNUS
  15. Wooclap
  16. Kahoot!
  17. Quizizz
  18. Blooket
  19. Gimkit
  20. Quizalize
  21. Zoom
  22. LearnDash
Support file formats
  1. docx
  2. json (Google Form)
  3. Canvas, Brightspace, itslearning, NEO LMS QTI zip file
  4. Blackboard pools and tests zip file
  5. Common cartridge imscc file
  6. QTI 1.2 zip file
  7. QTI 2.1 zip file
  8. QTI 2.2 zip file
  9. Moodle XML file
  10. Cognero QTI zip file
  11. WebCT zip file
  12. pdf (discouraged)
Setting the Correct Answer
To set the correct answers for each question, you can either use our web interface or do it directly in your docx file.

In most cases, our system would be able to intelligently infer where the answers are in your docx file. If however you are facing difficulties in getting your answers picked up, here are four surefire ways to annotate the correct answer for MCQs.

You can annotate the correct answer in MCQs using either:
  • Bold
  • Highlight
  • Answer tag
  • Asterisk

Here's some examples,

1.  Which color of light has the shortest frequency?

   a) Blue

   b) Red

   c) Green

   d) Orange

2.  Who is the first President of the United States?

   (a) George Bush

  (b) George Washington

   (c) George Clooney

   (d) George Russell

3.  What is the chemical formula of water?

   a. O2H

   b. HO2

   *c. H2O

   d. OH2

4.  T* F  The sky is blue.

Specifically, you can
  • Highlight the entire choice option.
  • Bold the entire choice option.
  • Add asterisk * on the immediate right of the correct option.
  • Add asterisk * on the immediate left of the correct option.

For True-false questions, you may even simply leave the correct answer directly below the question body. Here's some example.

1. The earth has two moons.


2. There are seven continents in the world.


3. New Mexico is part of Mexico.


For open ended questions, you can only use Answer: tag to annotate the correct answer. Append the tag at the end of each question like so:

5.  Process H also occurs in plant P. The diagram shows how a fruit is formed from the flower of plant P. The fruit of plant P has also been cut open.

open ended question

(i)  Describe the process G.

   Answer: Process G is pollination

Any variant of answer: or ans: is accepted. The colon : after ans must be present.

Alternatively, you can also leave all the answers in an Answer Scheme at the end of the document too. Please be sure to start the answer scheme with the word Answer Scheme.

(all the questions from 1 to 5) ...

Answer Scheme

1) a

2) b

3) c

4) T

5) Process G is pollination

Finally, setting of answers inside pdf files is currently not supported but will be in the near future.
Setting the Feedback
Currently, feedback can set for any question type by using the Feedback: or Explanation: tag. Here's an example.

1)  What is the color of the sky?

  a) Orange

  b) Red

  c) Blue

  d) Green

Answer: c

Explanation: The color of the sky is blue due to rayleigh scattering.

Feedback will be shown to the learner after an attempt, regardless of whether they got it right or wrong.

If you want to feedback to be displayed specifically for when the response is correct or incorrect use the following tags respectively Correct Feedback: and Incorrect Feedback:

Currently, choice specific feedback for MCQ is not available. Please reach out to support if you need it.
Standard Question Formatting
If you are facing difficulties converting your files, we recommend that adhere these standard formatting guideline:
  • All questions should start with a question number following by parenthesis.
  • Question content should be after the question number and not before.
  • All MCQ options should start with an alphabetical label followed by a parenthesis.
  • Answers are annotated using asterisk on the immediate right of the correct answer.

Here's an example.

1)  How many days are there in a year?

  a) 360 days

  b) 365 days*

  c) 361 days

  d) 375 days

We accept any format as long as it's prepared for classroom use. But if you are facing issues trying to get your question recognised, this is a surefire way to do so. Please do not preemptively style your quiz in this format before verifying that it fails on our system. Our mission is to help you save time, not give you more work to do.
Non Standard Question Formatting
In cases where you want to create a quiz in a quick and dirty way, this is the most barebone and stripped down format we accept.

What is the largest living terrestrial animal on earth?





The earth rotates around the sun.


You can forgo both (1) starting the question with a question number and (2) starting the mcq option with an alphabetical label.

Regardless of how you choose to create your quiz, please ensure that either all or none of the questions starts with question number. We do not accept inconsistent quiz structure.

Lastly, if you choose to start with a question number for each quiz question, there's more than one way to define them. Here's two ways.

Question 1.

What is the largest living animal on earth?

  A) Blue whale

  B) Giant Squid

  C) Elephant

  D) Crocodile

  Ans: A

Question: 2

What is the largest living terrestrial animal on earth?

  A) Rhinoceros

  B) Hippopotamus

  C) Elephant*

  D) Giraffe

The bottom line is that you should just submit your quiz file as is for conversion. If it doesn't convert optimally, then you can make adjustments. We support a lot more formats that what is on this user guide.
Non Standard MCQ
There's a huge variety of ways MCQs can be created. Here are some non standard MCQ that we support.

6.  Pregnant patients at term increase their tidal volume by approximately:





When an MCQ is without option labels (i.e. ABCD), it must have a correct answer annotated by bold or asterisk and a minimum of four options to be registered as an MCQ.

7.  How many litres of blood does a human body have?

  • two litres
  • three litres
  • four litres
  • five litres
Bullet points can also be used in place of regular option labels. Currently, only 4 and 5 bullet point options are supported.

8.  How many bones does the adult human body have?

  1) 124

  2) 168

  3) 206

  4) 251

MCQ option labels can be numeric too (i.e. 1234 instead of ABCD).

Lastly, please note that while we support non standard MCQ formats, you are discouraged from using it as those formats are inherently ambiguous and might convert sub-optimally in some edge cases.
Multiple Response Question
Multiple response question (MRQ) is the same as MCQ except that learners can select two or more options. Creating an MRQ is the same as how you would create an MCQ, only that you annotate more than one option as the correct answer.

6.  Select all the states that are part of the European Union.

   A) Vietnam

   B) Brazil

   C) France*

   D) Germany

   *E) Italy

In the above example, the correct answer is C), D) and E).

You can also define the correct answer using the ans: tag.

6.  Which options belows are consider organs of the human body. Select all that apply.

   A) Skin

   B) Hair

   C) Brain

   D) Toe

   E) Heart

   Ans: A, C, E

Matching Question
Matching question is a question type where learners have a associate elements of two list with each other. Here's an example:

Match the following terms with their definitions:

1. Atrocity

2. Fanatical

3. Pensive

a. An extremely wicked or cruel act.

b. Filled with excessive and single-minded zeal.

c. Engaged in, involving, or reflecting deep or serious thought.

When exported to your LMS, it will be rendered as such:

Match the following terms with their definitions:

1. Atrocity

2. Fanatical

3. Pensive

To register as matching question, there must be an instruction within the question text that contains "match the ...." (or equivalent) to hint that it is a matching question. Also, in this format, you cannot set the correct answer for the questions. You will have to use our web interface to do so after conversion has taken place.

If you want to define the correct answer together with the questions, here's how you can do it:

7. Match the invention with its inventor.

  Thomas Edison = Light Bulb

  Alexander Graham Bell = Telephone

  Wright brothers = Aeroplane

When exported to your LMS, it will be rendered as such:

7. Match the invention with its inventor.

  Thomas Edison

  Alexander Graham Bell

  Wright brothers

The items on the left of the equal sign would be treated as the matching questions, and the right would be treated as the correct matching options.
Cloze Question
Cloze questions are questions that get the learner to fill-in-the-blank. It can be constructed like so:

15. The Grand Canyon is a steep-sided canyon carved by the Colorado River in _________ [*Arizona, Utah, California, Nevada]. The canyon is a result of _________ [erosion, weathering] which exposes one of the most complete geologic columns on the planet.

The cloze question starts with a question number (recommended practice for all questions too) followed by the question text. To create the "blanks", use a series of underscore (this symbol _) as you might do if you were preparing the quiz for normal classroom use.

There are two types of cloze questions you can choose from. Either select-dropdown or fill-in-the-blank. Here's how you are create them:

Select-dropdown: options are defined inside the square brackets with the correct answer annotated by asterisk either at the front or the back of the option.

For example, ________ [*Arizona, Utah, California, Nevada] will render as

Fill-in-the-blank: answers should be defined inside square brackets, separated by a comma between alternative correct answers.

For example, _______ [Arizona, Utah] will be rendered as .

Finally, please note that different LMS has different level of support for this very useful question type.

Cloze Type Canvas Moodle Blackboard Schoology Brightspace NEO LMS itslearning
Fill-in-the-blanks only
Select-dropdown only
Fill-in-the-blanks and select-dropdown

You can always use our platform to adminster the questions if your LMS doesn't support it. We provide a lightweight quiz engine for you to do that.
Shared Stimulus
It is common when creating quiz questions to have multiple questions refer to the same data (aka. shared stimulus). Here's an example,

Using the table below, answer questions 10 to 12.

  Knocky Flor Ella Juan
Breed Jack Russell Poodle Streetdog Cocker Spaniel
Age 16 9 10 5
Owner Mother-in-law Me Me Sister-in-law
Eating Habits Eats everyone's leftovers Nibbles at food Hearty eater Will eat till he explodes

10. Who is the owner of Ella?

Ans: me

11. Which dog is the oldest?

Ans: Knocky

12. What breed is Juan?

Ans: Cocker Spaniel

After conversion, the shared stimulus (in this case the table) will be included in each of the individual question.

One surefire way to ensure that the shared stimulus is recognised by the system is to use the phrase

".... to answer questions X to Y" or "... to answer the next X questions",

where X and Y are numbers.

Variants of the same phrasing will also be accepted.
Missing Charts, Shapes or Grouped Images
Charts, shapes and grouped images are not extracted from your Word document, only standalone images. We suggest that you replace those objects with the screenshot of itself. This can be done on the original word doc or on our web interface after quiz question extraction.

Maths Equation Errors
If the extracted maths equation looks compressed and pixelated, this is due to the use of MathType Equation in your document. MathType equations were used in old word documents because Microsoft Word didn't have good support for rendering maths equations in the past, so teachers would install a separate plugin for it.

Now, however, you should convert them into the newer Office Math Equation. To identify whether an equation is a MathType equation, click on it. If you see dashed line borders and small grey squares like the image below, then it is math type.
math type equation
If however, you see solid border with two grey tabs on the side, then its Office Math and no further action is required.
office math equation
Once the offending offending MathType Equation is found, double click on it and a pop up will appear.
convert math type to office math equation
Check the box "Apply to all equations" and click the "yes" button. All the MathType equation will be automatically converted into Office Math and you can resubmit your file for conversion on GETMARKED Digitaliser.

Handling Conversion Errors
If there are errors in the extracted questions or if your document fails to convert completely, here are some steps you can take:

  • Email support with the document and specify the problem that you face. We will get back to you in 24hrs.
  • Format the document as if you will be using it in classroom. Quiz documents that are generated by a LMS tends not to convert well.
  • Remove all bold, underline and italics. Annotate answers using only asterisk on the immediate right of the correct answer.
  • Remove content that has nothing to do with the quiz. Things like cover page, table of content, answer scheme should be removed.
  • If your document is huge, reduce half the content and try converting again. Repeat until it works.
Converting Mht Word file
Submitting an Mht docx file for import will result in a no data found in file error. A Mht Word file is a Docx file where the underlying data is stored as HTML. This is a very uncommon format and is not supported by us.

Luckily, it very easy to convert it into a proper Word document file. Open the offending file using Microsoft Word, make any changes to the document (e.g. add a new line by pressing the Enter key). Then Save as a new docx file. Resubmitting the new file and it will now import correctly in GETMARKED Digitaliser.
Prefer docx over PDF
PDF conversion is meant for legacy worksheets where the instructor only have hardcopies of it left. If you have the original docx file, you should use docx. Conversion from docx file is more performant. Many of the features are only available in docx conversion.

If your pdf was originally exported from Word, then you can use Microsoft Word to open the pdf file and convert it back into docx. The docx file, while not the same as the original, would still perform better than a pdf.

If you have to use pdf (due to legacy hardcopy worksheets), then we recommended that each pdf file is less than 15 pages and only contains the quiz questions and nothing else (i.e. remove the cover page, answer scheme, etc.). Additionally, the scan quality should be at least 150 dpi greyscale. Black and white is not recommended. Docx files have no such limitations.
How to export quizzes from your LMS
Below are links to resources that will show you how to export your quiz and question banks from your LMS:
Should you encounter any difficulties with the conversion, please reach out to We are very responsive and will get back to you within one work day.