Revision item

A Revision item requires that the participant find and correct language errors (spelling, grammar, punctuation, syntax, etc.) in the text.

At the top and bottom of the page, you can use the Save button to save the information you have entered, Cancel if you choose not to save the last changes, and Preview to see how the item will appear when published. This last command allows you to see the item exactly as it will appear to participants.

Note that when you add an item to the library of a given project for which you have invited people to collaborate with you, this item will also be available for them to consult or modify as needed. In addition, if one of the collaborators modifies an item, the modified version of the item will appear in all of the questionnaires and assessments that use this item.

An item is defined in three tabs: ContentAdd-ons and Parameters.


The Content tab is used to define what makes up the item.

Item title

The item title is the same as the question title. This is the title displayed for participants and in the Title column in the list of items.

Item type

The item type is Revision.

Question text

Write the instruction that will be shown to participants. Use the editing tools as needed.

Enter the text and select each pitfall or error to add feedback

  1. Enter the complete text with the errors and pitfalls.
  2. Select a word that needs to be corrected or that will provide feedback. You must select the entire word, with its immediate punctuation (comma, quotation mark, period, colon, semi-colon, parenthesis, etc.), if applicable, but no additional spaces (see how). 
  3. After highlighting the word, click on Add feedback.
  4. Enter at least one expected answer (correctly written or incorrectly written, depending on the case) and, if you wish, the appropriate feedback for each answer.
  5. Check the box corresponding to all the correct answers.
  6. Enter feedback for all the unpredicted answers (optional).
  7. Check the box in the lower left-hand corner if you want to attribute a point to this pitfall or error. You can, for example, not penalize a participant if they apply traditional spelling to a word written with rectified (new) spelling. If so, you must leave this box unchecked.
NOTE: The feedback fields should be used to give a meaningful explanation or feedback other than Correct answer or Incorrect answer, because this general feedback is given automatically upon validation. You are not required to write feedback, but it is worth the effort because it adds to the teaching potential of the questions.

IMPORTANT: The pitfalls and errors can only concern one word at a time and the corrections cannot add or remove a word from the text. It is therefore not possible, for example, to correct an entire word (pitfall or error) by replacing it with two separate words or deleting the word.

Try to anticipate correct, but non-vital changes and all the appropriate corrections for each word (e.g. traditional/rectified spelling, optional commas, optional grammatical agreements in French).

Given that this is a complex item to create, be sure to test it several times before publishing, to ensure that it is working properly.

The arrows above the editing area of a pitfall or error serve to quickly move from one pitfall or error to the next, which is very useful for revising feedback.

To delete all the pitfalls and errors:

In the text’s editing area, select the entire texte and click on Delete all selected.

To delete one pitfall or error:

In the pitfall or error’s editing area, click on Delete this selection.

To delete all the text:

In the text’s editing area, click on Delete text.

IMPORTANT: If you want to delete a word to which you have added a pitfall or error, always delete the selection before deleting the word. Deleting the word directly will offset the feedback.


The Add-ons tab allows you to add complementary information to the item.

Add-ons 1 and 2

Enter complementary information related to the question. Use the editing tools as needed. For example, you could give clues to help participants better understand.

Media in the header

The header of an item can contain one or more media files. Add a title and descriptive text to the media files (optional). Use the editing tools as needed.

Use the commands Add image fileAdd audio file or Add video file to choose the media file or files for the header. You can use a file that is already saved in your library (see how), or you can import a new file from another source (see how).


The Parameters tab allows you to define the specific attributes for this item type.


An item can belong to a category or not. To associate an item with an existing category, choose a category from the drop-down menu. To associate an item with a new category, write a name for the category in the Add a new category field as needed. The new category will be created at the same time as the new item and will be added to the library under My categories.

Item parameters

  • Weighting: Enter the number of points given to the question.
  • Negative score: Check this box if you want the points to go into the negative. For example, if a text contains 10 errors and the participant corrects two (+2), but adds 10 more (-10), their score will be -8/10. 
  • Display correct answer: Select the appropriate option, depending if you want the participant to have access to the correct answer after submitting their answer. Note that this option is automatically deactivated for summative assessments.
  • For the correction, take into account..Indicate whether the correction is case-sensitive (upper or lower case) and if punctuation needs to be taken into account. It’s important to check these boxes if upper/lower case or punctuations errors have been added to the text.

General messages about the questionnaire language  

The general messages appear when participants decide to validate their answers. These messages are defined for all the items of the same type by the person responsible for the questionnaire. By default, a Correct answer is marked in green, an Incorrect answer is marked in red, and a Partial answer is marked in orange. However, you can provide different messages when creating the item by clicking on Modify values for this item only.

In order to add an image, a video or an audio file to a message, you can use a file that is already saved in your library (see how), or you can import a new file from another source (see how).


Notes can help you manage the content or work in collaboration with a colleague and items that are marked “To be reviewed”, “To be completed”, “Check copyrights”, etc.). Its content does not appear in the published assessments.