If you are new to Wiris Quizzes this is the best starting point in order to familiarize yourself with the different options and interface. We will guide you step by step through several common use case examples.
In the last years of primary school, the students learn to operate with fractions. Let us see how we create a question with Wiris Quizzes step by step asking, for instance, for the sum of two fractions. The grading will be done automatically, and for now, both simplified and not simplified answers will be count as correct.

Select the question type

First, we need to select which type of question we will use. Among all the possible options, the best one for this example of adding 2 fractions is Short answer. because we expect the student to answer with just the result.

Write the statement

Second, we will write the statement of the problem. Let us ask the students to sum 1 fourth and 5 over 4. Fractions can be written with MathType.

Write the correct answer

Third, open Wiris Quizzes Studio by clicking .

Wiris Quizzes Studio is the main workspace. Here we will provide the correct answer, as well as some matching criteria regarding the form of the answer. For instance, in the next example, we will see how to set the question so that only simplified fractions are correct. More detailed information about Wiris Quizzes Studio is in its main page, its dedicated page.

Go to Correct answer tab and provide the correct answer to the question. Make sure MathType embedded or MathType in popup is selected, so that students can write the fraction properly.

Preview the question and save the changes

It is always a good practice, even with simple questions, to test how they behave using the Preview tab. We can check that all the correct answer the student may provide are indeed correct.

The view that we have on this tab is the same as the students will have. Since they will see the same MathType editor that we see, it is important we select MathType embedded or MathType in popup on the Correct answer tab.

Once you have finished testing the question, click OK so changes are saved and Wiris Quizzes Studio window closes.

Assign full grade and save the question

Finally, we must assign the full grade to the correct answer and save the question by clicking Save and continue editing. This way, we will save the question, but we will be left on the same page.

Student view

Now, we should be able to preview the question. Click Preview.

A new window will show up with the question shown as the student will see it. Here, we can test the behavior of the question again.

Note we're not requiring the answer to be simplified. We'll look at how to do that in the next exercise.

Based on the previous question, now we want to go a step further: now it is not only sufficient to compute the sum of two fractions but it should also be simplified. For instance, in the previous question, only 3 over 2 would have been the correct answer.

Select the question type

First, we need to select which type of question we will use. Among all the possible options, the best one here is Short answer because we expect the student to answer with just the result.

Write the statement

Second, we have to write the statement of the problem. Let us ask the students to sum 1 fourth and 5 over 4. Fractions can be written with MathType.

Write the correct answer

Third, open Wiris Quizzes Studio by clicking on .

Go to Correct answer tab and provide the correct answer to the question. Make sure MathType embedded or MathType in popup is selected.

Configure the evaluation properties

Go to Validation tab and select the is simplified option under Additional properties:

Preview the question and save the changes

It is always a good practice, even with simple questions, to test how they behave using the Preview tab. We can check that all the correct answers the student may provides are indeed correct. Note that if the answer is not simplified, the question is marked incorrect.

The view that we have on this tab is the same as the students will have. Since they will see the same MathType editor that we see, it is important we select MathType embedded or MathType in popup on the Correct answer tab.

Once you have finished testing the question, click OK so changes are saved and Wiris Quizzes Studio window closes.

Assign full grade and save the question

Finally, we must assign the full grade to the correct answer and save the question by clicking on Save and continue editing. This way, we will save the question, but we will be left on the same page.

Student view

Now, we should be able to preview the question. Click Preview.

A new window will show up with the question shown as the student will see it. Here, we can test the behavior of the question again.

It is possible to create a second answer so that if a student were to answer 6 over 4, they would get, for instance, half of the score. The same idea is used in this example we will visit later. Try it yourself when you finish this tutorial!
Imagine you want to include this question on a quiz. All the students will see the same question with the same fraction! Wouldn't it be nice to have one different question for each student? Well, this is possible with Wiris Quizzes with a simple command.
The idea is to generate four random numbers that they will be the numerators and denominators of our fractions, so every time a student opens the question, different numbers will appear in the statement.
And what about the correct answer? Do we need to assign to each possible case its correct answer? Of course not! We will treat fractions as variables, perform their sum inside CalcMe, so it will do the computations for us, and then we set the result as the correct answer.

Select the question type

First, we need to select which type of question we will use. Just as in the examples above, the best of the possible options is Short answer because we expect the student to answer with just the result.

Create random numbers

Before writing the statement, let us write the algorithm of the question. Open Wiris Quizzes Studio by clicking .

Go to Variables tab. What you see is CalcMe:

For getting started with CalcMe, see its very very basic guide.

The random command allows us to retrieve a random number in a given interval. We need four random numbers: two numerators and two denominators; that we will call num1, num2, den1, den2 (the name of the variables is important, as we will see later on). Let us write the code

Now we have four random numbers between 1 and 9 (both included). We will also compute the sum of the fractions they define and store the result in a variable

That is all we have to do regarding the algorithm. Click the arrow on the upper left corner to go back to Wiris Quizzes Studio.

Write the correct answer

Click the Correct answer tab and write the correct answer. Now it is not a number, it is a variable that we called sol. In order to write a variable anywhere outside CalcMe, we must precede the name of the variable with the pound sign #. Therefore, we will write #sol in the correct answer field.

Recall the student will see the same MathType editor as we do in the Correct answer or Preview tab, so it is very important for either the MathType embedded or MathType in popup option to be selected.

Make sure it all works

Finally, go to Preview tab and try some possible answers: check everything works as expected. Although the correct answer provided is simplified, if no additional property is selected, any answer mathematically equal to the correct one will be correct.

Now we have another button next to the correct answer in the Preview tab: . This button appears because our algorithm deals with randomness. Every time we click this button, the algorithm will be re-executed and the random numbers will change.

The view we have on this tab is the same as the students will have. Therefore, they will see the same MathType editor we see, so it is important we select MathType embedded or MathType in popup on the Correct answer tab.

Save the changes and assign full grade

Once you have finished testing the question, click OK so changes are saved and Wiris Quizzes Studio window closes.

Assign the full grade to the correct answer.

Write the statement

Now we proceed to write the statement of the problem. Recall that our numerators and denominators were stored in variables called num1, num2, den1, den2. In the same way as in Correct answer tab, we have to write the name of the variables preceded by the pound sign #. Fractions can be written with MathType.

Finally, save the question by clicking Save and continue editing so the question is saved but we still viewing the editing page.

Student view

Now, we should be able to preview the question. Click Preview.

A new window will show up with the question shown as the student will see it. Here we can test the behavior of the question again.

Every time we preview the question, the numbers in the statement will be different.

One of the most common questions in the first years of high-school is to ask the area of a rectangle, which is simply the result of multiplying the length of its base by its height. This type of question is also useful to check if the students have understood how to work with units.
This example will let us introduce units of measure in our questions.

Select the question type

Let's select which type of question we will use. As above, the best of the possible options here is Short answer because we expect the student to answer with just the result.

Write the statement

Second, let us write the statement of the problem. We will ask the students, for instance, to compute the area of a rectangle with base 4 space text cm end text and height 5 space text cm end text.

Choose Quantity mode

Open Wiris Quizzes Studio by clicking and go to Validation tab.

In the Allowed input field, the General mode is selected by default. This mode is useful for most of the questions, but there are two modes more. We will use Text mode when the student has to write simple text as an answer. Since we will be dealing with units (centimeters, in this case), the best mode here is Quantity.

Provide the Correct answer

Wiris Quizzes is capable of automatically grading the answer written by the student once we provide the correct answer. It will not only compare if the answer is the same, but it will also check if the answers are mathematically equal. In our example, it will grade as correct both 4 times 5 space text cm end text squared and Error converting from MathML to accessible text., for instance.

We will provide 20 space text cm end text squared as the correct answer. Make sure MathType embedded or MathType in popup is selected, otherwise the students will not be able to write the square. The student will see the same MathType editor as we do in the Correct answer or Preview tab.

Note that both c (centi) and m (meters) are colored blue because Quantity mode is selected so that they are understood as a metric prefix and a unit, respectively.

Preview the question and save the changes

It is always a good practice, even with simple questions, to test how they behave using the Preview tab. We can check that all the correct answers the student may provide are indeed correct. Moreover, we can see that if the students forget to write the units, they will get zero points.

Once you have finished testing the question, click OK so changes are saved and Wiris Quizzes Studio window closes.

Assign full grade and save the question

Finally, we must assign the full grade to the correct answer and save the question by clicking Save and continue editing. This way, we will save the question, but we will be left on the same page.

Not assigning the full grade to a response is useful when we want to penalize some answers. In this case, for instance, we could create a second answer without the units and assign to it the 50% of the grade. There's another example below that illustrates this.

Student view

Now, we should be able to preview the question. Click Preview.

A new window will show up with the question shown as the student will see it. Here, we can test the behavior of the question again.

Consider the question in the previous example. Imagine we want to include that question on a quiz. All the students will see the same question with the same dimensions! Wouldn't it be nice to have a different question for each student? This is possible with a simple command in Wiris Quizzes.
The idea is to generate two random numbers for base and height, so every time a student opens the question, there will be different numbers in the statement.
And what about the correct answer? Do we need to assign a correct answer to each possible case? Of course not! We will treat measures as variables, evaluate their product inside CalcMe so it will do the computations for us, and then we set as correct answer the result.

Select the question type

First, we need to select which type of question we will use. Among all the possible options, the best one here is Short answer because we expect the student to answer with just the result.

Choose Quantity mode

Before writing the statement, let us write the algorithm of the question. Open Wiris Quizzes Studio by clicking and go to Validation tab.

In the Allowed input field, the General mode is selected by default. This mode is useful for most of the questions, but there are two modes more. We will use Text mode when the student has to write simple text as an answer. Since we will be dealing with units (centimeters, in this case), the best mode here is Quantity.

Create random numbers

Third, we will write the algorithm. Go to Variables tab. What you see is CalcMe:

For getting started with CalcMe, see its very very basic guide.

The random command allows us to retrieve a random number in a given interval. We need two random numbers: one for the rectangle's base and one for the height. We will name these b and h, respectively. The name of the variables is important, as we've seen in previous examples. We will also compute the product of the quantities and store the result in a variable. Let's write the code.

Units need to be introduced via the symbols available under the Units of measure tab. See the very very basic guide of CalcMe for more information.

Now we have two random units whose magnitude is between 1 and 9, inclusive. We will also compute the product of the quantities and store the result in a variable.

Note the solution has the proper units, and it changes every time we execute the algorithm. That is all we have to do regarding the algorithm. Click the arrow on the upper left corner to go back to Wiris Quizzes Studio.

Write the correct answer

Click the Correct answer tab and write the correct answer. It is not a number yet; it is a variable we named sol. In order to write a variable anywhere outside CalcMe, we must precede the name of the variable with the pound sign #.

Recall the student will see the same MathType editor as we do in the Correct answer or Preview tab, so it is very important for either the MathType embedded or MathType in popup option to be selected.

Note s and l are in blue because they are understood as units (seconds and liters, respectively) and Quantity mode is selected. However, since they are preceded by #, they are understood as part of a variable's name rather than as a unit.

Preview the question and save the changes

It is always a good practice, even with simple questions, to test how they behave using the Preview tab. We can check that all the correct answers the student may provide are indeed correct. Moreover, we can see that if the students forget to write the units, they will get zero points.

Now we have another button next to the correct answer in the Preview tab: . This button appears because our algorithm deals with randomness. Every time we click this button, the algorithm will be re-executed and the random numbers will change.

Once you have finished testing the question, click OK so changes are saved and Wiris Quizzes Studio window closes.

Assign full grade

Assign the full grade to the correct answer.

Write the statement

We have to write the statement of the problem. Recall we have stored the base length and height in two variables named b and h, respectively. Therefore, as for the correct answer, we have to write the name of the variables preceded by the pound symbol #.

Finally, save the question by clicking Save changes and continue editing.

Student view

Now, we should be able to preview the question. Click Preview.

A new window will show up with the question shown as the student will see it. Then, we can test the behavior of the question again.

Every time we preview the question, the numbers in the statement will be different.

In the previous examples, we have mentioned it is possible to penalize the grade of students if they forget to write the units. Let's create a random question as before but
  • Students will get 100% of the score if they write the area of the rectangle with the correct units.
  • Students will get 50% of the score if they write the area of the rectangle without units.

Select the question type

First, we need to select which type of question we will use. As above, the best of the possible options for this question is Short answer because we expect the student to answer with just the result.

Choose Quantity mode

Before writing the statement, let's write the algorithm of the question. Open Wiris Quizzes Studio by clicking and then the Validation tab.

In the Allowed input field, the General mode is selected by default. This mode is useful for most of the questions, but there are two additional modes. We will use Text mode when the student has to write simple text as an answer. Since we will be dealing with units (centimeters, in this case), the best mode here is Quantity.

Create random numbers

To write the algorithm, go to the Variables tab. What you see is CalcMe:

For getting started with CalcMe, see its very very basic guide.

The random command allows us to retrieve a random number in a given interval. We need two random numbers: one for the rectangle's base and one for the height. We will name these b and h, respectively. The name of the variables is important, as we've seen in previous examples. We will also compute the product of the quantities and store the result in a variable. Let's write the code.

Note the solution changes every time we execute the algorithm.

Note in this example the variables do not have units. In the previous example we included units as part of the variable, but we'll do it differently in this example.

That is all we have to do regarding the algorithm. Click the arrow on the upper left corner to go back to Wiris Quizzes Studio.

Write the correct answer

Click the Correct answer tab and write the correct answer. It is not a number yet; it is a variable we named sol. In order to write a variable anywhere outside CalcMe, we must precede the name of the variable with the pound sign #. Since the variable does not have units, we'll include them here.

Recall the student will see the same MathType editor as we do in the Correct answer or Preview tab, so it is very important for either the MathType embedded or MathType in popup option to be selected.

units

Note s and l are in blue because they are understood as units (seconds and liters, respectively) and Quantity mode is selected. However, since they are preceded by #, they are understood as part of the variable's name.

Centimeters c and m are colored blue for the same reason. The space between the variable's name and cm is important, otherwise, it would be understood as a variable called solcm.

Preview the question and save the changes

It's always a good practice, even with simple questions, to test how they behave using the Preview tab. We can check that all the correct answers the student may provide are indeed correct. Moreover, we can see if the students forget to write the units, they will get zero points.

Now we have another button next to the correct answer in the Preview tab: . This button appears because our algorithm deals with randomness. Every time we click this button, the algorithm will be re-executed and the random numbers will change.

Once you have finished testing the question, click OK so changes are saved and the Wiris Quizzes Studio window closes.

Assign full grade

Assign the full grade to the correct answer. Note the answer has units.

Write the statement

We have to write the statement of the problem. Recall we have stored the base length and height in two variables called b and h, respectively. Therefore, as for the correct answer, we have to write the name of the variables preceded by the pound symbol #. Now we have to include the units in the statement since the variables are just numbers, not quantities.

Finally, save the question by clicking Save and continue editing.

Penalization to those who forget the units

Until now, this question behaves exactly the same as the previous one. Therefore, let us add the penalization to those students who forget to write the units.

Click Blank for another choice, so a new possible answer shows

Open Wiris Quizzes Studio in Answer 2:

Notice everything is the same as before except that now the Correct answer tab is empty. Provide as correct answer the variable sol as before but now do not write the units.

Save the changes by clicking OK.

Assign the 50% of the score to the second answer, so the Answers field looks like

What we are saying here is: if the answer matches the criteria of Answer 1, the student will get 100% of the score. If instead, the answer matches the criteria of Answer 2, the student gets 50% of the score. If the answer matches neither the criteria for Answer 1 nor Answer 2, the student gets no credit.

Save the changes and preview the question

Finally, save the changes

and preview the question.

A new window will show up with the question shown as the student will see it. Then we can test the behavior of the question again.

Every time we preview the question, the numbers that will appear will be different.

In chemistry one may be interested in converting from grams of a substance to number of moles and particles. In this example, we will create a question that given the mass of a substance in grams, the student should compute how many moles and molecules it contains, correct to 2 correct decimal places.

Select the question type

First, we need to select which type of question we will use. There are several possible options, and once again the best one for this example is Short answer, because we expect the student to answer with just the result.

Write the statement

Now let's write the statement of the problem. We will ask the students to convert 34 space text g end text of ammonia, NH subscript 3, to number of moles and particles.

Compute the correct answers

Open Wiris Quizzes Studio by clicking , then the Variables tab. What you see is CalcMe:

For getting started with CalcMe, see its very very basic guide.

We will use two variables to store the solutions to the two questions.

Provide both correct answers

In this example actually, we are asking two questions: the number of moles and the number of particles. How do we do this?

Go to Correct answer tab and modify it so it looks like the image below. It is very important that MathType in popup is selected, so the students are able to write the correct answers properly. Recall that the student will see the same MathType editor as we do in the Correct answer or Preview tab.

Compound answer

Note we have selected Compound answer. This option allows us to ask for multiple answers in a single question, so that is very useful when both subquestions are related. Everything on the left-hand side of the equal sign will be part of the statement, and on the right-hand side a box will appear so the students are able to answer.

We have two choices regarding the grading: either the whole question is correct if all the subquestions are correct or the whole mark is the sum of the distributed grades for each subquestion. Here, for instance, we distribute the grade equally: 50% for the first one and 50% for the second one.

Preview the question

It is always a good practice, even with simple questions, to test how they behave using the Preview tab. We can make sure the whole grade is a combination of each subquestion's grade.

Change the tolerance

Until now, we were using the default tolerance setting: 0.1 percent error. In this question we want to count as correct an answer if it is correct to two correct decimal places.

Go to Validation tab and modify the tolerance field so it becomes 2 decimal places, as in the animation below.

Are you interested in all the possible tolerance options and how they work? Visit this detailed tolerance page.

Save the question and assign full grade

Click OK so changes are saved and Wiris Quizzes Studio window closes.

Next, assign the full grade to the correct answer.

Preview the question

Save the question by clicking Save changes and continue editing.

Click Preview.

A new window will show up with the question shown as the student will see it. Here, we can test the behavior of the question again.

Note that if the student's answer does not have two correct decimal places, the question is not completely correct.

In the following example we will ask the student to match a function with its graph. Thus, we will incorporate a plot in the statement. Let us see how it is done.

Select the question type

First, we will select which type of question we will use. Until now, we have been using Short answer, but now we will choose Multiple choice since we want the student to choose the correct choice among all the possibilities that we will give.

Construct the plot

For instance, we will show the plot of x squared and then students will have to choose from some possibilities. Let us then create the plot of x squared. Open Wiris Quizzes Studio by clicking , then go to Variables tab and open CalcMe.

We directly write x squared and click on Plot. Pay attention that the graph appears in the first plotter plotter1.

That is all we have to do regarding the algorithm. Click the arrow on the upper left corner to go back to Wiris Quizzes Studio.

Click OK so changes are saved and Wiris Quizzes Studio window closes.

Create the possible answers

On the Answers section, create for instance three different choices x squared, x cubed and 2 x plus 1 and assign 100% of the grade to correct one.

It is possible to specify some feedback for each choice. Feedback is what appears once the student has answered the question. We can write Congratulations! for those who answer correctly and Your answer is not correct, that is a parabola! for those who fail.

Write the statement

Finally, let us write the statement of the problem. Recall that the graph of the function was plotted in the first plotter plotter1, so it will be our variable. Then we need to precede by # the name of the variable, in this case plotter1. The statement will look like

Label of the options and shuffling

We have almost finished, but small details are missing. We should specify that only one answer is correct, whether we want to shuffle the choices or not (so that the order in which the choices appear is different for each student), and which label is used for each choice.

Save and preview the question

We have finished with the creation of the question. Now, save the question by clicking Save and continue editing.

Click Preview.

A new window will show up with the question shown as the student will see it. Then, we can test the behavior of the question again.

In the following example we will ask the student to write the expression of a polynomial given its roots. Moreover, we will plot the polynomial the student gives so they can compare their solution with the correct one.

Select the question type

We'll select which type of question we will use. Most of the examples on this page use Short answer. Since we expect the student to answer this question with just the result, Short answer is the best of all the of all the possible options for this one as well.

Write the statement

Now let's write the statement of the problem. We will ask the students to write a monic polynomial of degree two with roots 2 and -3.

Compute the correct answers

Open Wiris Quizzes Studio by clicking , then go to Correct answer tab and write the correct answer.

Since we are checking if the student's answer and the correct answer are mathematically equal, the order in which we write the correct answer is not important.

Store the student answer

Next, go to Variables tab and open CalcMe

The student's answer is stored in a parameter called answer. Therefore, in order to work with it, we have to define this parameter. As we want to compare the correct answer and the student's answer, we have to plot both of them. The code to do so looks like:

The default value for the parameter answer is zero, that why the red plot is always zero. Don't worry; it will look nicer with the answer from the student.

Preview the question

It is always a good practice, even with simple questions, to test how they behave using the Preview tab. Once again, the order is not important. The plot will appear in the preview of the whole question.

If the student answers with the polynomial in expanded form, it will be graded as correct since it will be mathematically equal to the correct answer we have provided.

Save the question and assign full grade

Click OK so changes are saved and Wiris Quizzes Studio window closes.

Next, assign the full grade to the correct answer.

Add the feedback

Go to the General feedback field. Everything we write here will be shown to the students once they answer. Therefore, for instance, we can write here all the steps they have to carry out when solving a problem or to compare their answer with the correct one, as we will do here.

Recall the graph of the correct answer is blue and the one stored in the parameter answer (the student's answer) is red. The plot is stored in a variable called plotter1, so we will include it on the feedback preceded with the pound symbol #.

Preview the question

Save the question by clicking Save and continue editing.

Click Preview.

A new window will show up with the question shown as the student will see it. Then, we can test the behavior of the question again.