Navigation Menu

Click the "+" to see inside a chapter or use the search to the right.


Skip to end of metadata
Go to start of metadata

Enhanced Matching type items allow the pairing of items (textual content) defined in a graphical interface consisting of Token boxes and Target boxes. Unlike Matching type Items, here you can have a match between several Tokens and one Target. Also, it allows you to use conditional matching for scoring.

  1. Select the Develop Questions → Write Item menu.
  2. Click the Write Question link. 
  3. On the Write Question page, select Enhanced Matching from the Question Type drop-down list.

    Please visit the Language-related features in Items page to learn about the Language Code drop-down list.

Create an Enhanced Matching Item

  1. Enter a Question Stem providing information about the topic of the Enhanced Matching type item. This box uses a Rich Text editor, so it supports text formatting and inclusion of assets.
  2. You can add a background image to the Enhanced Matching item by clicking the Select/Upload Image button. This opens the Attach Asset pop-up window, where you can select the image to attach to the item in the background. 
    1. In the Attach Asset pop-up window, click Retrieve Assets.
    2. Click the Attach Asset  icon for the desired asset.


      If the required asset is not already available in the system, you can upload it by clicking the Upload Assets button, which opens the Upload Assets pop-up window, where you can upload an asset from your hard drive, to directly attach it to the item. The uploaded asset remains in the system in the same way as an ordinarily uploaded asset. For more details on attaching an image, refer to Upload an Asset.

    3. Click OK when the image has been attached message appears and Close the Attach Asset pop-up window.
      The image is inserted into the Matching Pairs canvas window.

      The background image is solely for cosmetic effect and is not functionally associated with the Enhanced Matching type item in any way. Therefore, it is possible to create and save an Enhanced Matching type item without the background image.

  3. Click Add Token to add a Token shape into the canvas. You can add as many Tokens as required for the item. Double-click its central area to edit the shape name.
  4. Next, click Add Target to add a Target shape into the canvas. You can add as many Targets as required for the item. Double-click its central area to edit the shape name.


    It is possible to insert multiple Token with only one Target. Candidates must place the correct Token on the Target to correctly answer the item. In this way, the other tokens act as distractors on the item.

  5. Click Add Label to create a Label. This is also a rectangular shape like Tokens and Targets, but its purpose is to visually group together Targets, Tokens, or Targets and Tokens, having some association with each other. The Label shape is enlarged to bring the group within its shape perimeter and it sits in the background with its group of Targets or Tokens in the foreground. Double-click its central area to edit the shape name.
  6. The Target, Token, and Label shapes can be dragged around to rearrange as required. They can also be resized by selecting them and dragging their corners or sides.
  7. Select any unwanted Token/Target shapes and click Delete to delete it.
  8. You can also format each shape individually by selecting it and clicking Properties. It is also possible to select multiple shapes by dragging the mouse cursor around them and then formatting them by clicking Properties. In this case, you will not be able to modify the text.

    The title of the Properties window appears as Token Properties if a Token is selected, Target Properties if a Target is selected, LABEL Properties if a Label is selected, and GROUP Properties if multiple shapes are selected.
    The Properties window allows you to set many attributes such as color for background, border, and text. You can set the font text, face, size and alignment and the shape border size. It is also possible to define the location of the shape by specifying the coordinates for the left and top. The shape dimensions can also be specified in the Height and Width boxes. Lastly, you can specify whether the selected shape should be in the foreground or background. By default, the newest shape is placed in the foreground, but it can be sent to the background from this control, which is useful with the “label” shape. The modified properties are applied to the selected shape(s) only after clicking the Apply button.


    If the properties of any shape are modified in the Properties window and the Properties window is closed without clicking the Apply button (by clicking the X on the top right), the changes are temporarily retained in the Properties window as long as another shape is not selected. These retained changes can be applied later by clicking the Properties button again and then clicking the Apply button. The unsaved changes are discarded if you click on any other shape before applying the properties to the original shape.

    Visit Work with the Shape Editor to learn more about the handling the shapes.

Save the Item

You have several options to Save the item.

  1. Click the Add Question to Case button save the item and create a new case. The item is automatically attached to the case. Only users with permission to create cases will see this button.
  2. Click the Save button. The item is saved and the item is checked out preventing other users from making edits to the item. You remain on the Write Question page where further edits can be made to the item.
  3. Click the Preview button. Changes to the item are saved, the item is checked-out, and the item is opened in the Preview window. Only users with permission to preview items will see this button.
  4. To save an incomplete item, click Save and Exit. The item is saved in a Draft state and checked-in so any user with access to the item may make edits to the item. It is visible in the Draft/Returned Questions tab of the Project Writing Summary page.
  5. To submit the item for review, click Submit. The item is saved and checked-in so any users with access to the item may make edits to the item. The item is advanced to the next reviewer in the list or to the next stage in the workflow.


The Scoring button allows a user to decide how scoring is made for the particular item. Click the Scoring button, the Scoring window opens. This window has two tabs Response Option and Scoring Rules.

Response Option:

This tab is used to select the Targets and their compatible Tokens. All the Targets are listed in a grid under Response Target column, and all available Tokens are shown in front of each Target under the Compatible Token(s) column.

The user can remove any of these Tokens by clicking on a Token under the Compatible Token(s) column and deselecting its check box. The deselected Token is immediately removed from the Compatible Token(s) list.


Correct answer(s) for each Target can be set in the Correct Token(s) (Key) column. Click the Token list under this column for a Target, you are able to view a list of Tokens from those selected earlier in the Compatible Token(s) column. The correct answer(s) can be selected here via check box.




When the Single Use Tokens check box is selected (default), a Token can only be used once in the item. If this check box is not selected, then it is possible to drop the same Token on multiple Targets.

While it is still possible to save an Enhanced Matching type item with one Token assigned to multiple Targets even when the Single Use Tokens check box is selected, the functionality takes effect in the Assessment Driver (such as Pearson VUE QTI Compiler), where the assigned Token is available for only one-time use.


When the Toggle idents check box is selected, the identifiers assigned to each of the Tokens and Targets in the background become visible in the canvas as well as in the Scoring window.

Response Option tab of the Scoring window:

Scoring Rules tab of the Scoring window:


Learn about specifying a custom value for the identifier by viewing the Work with the Shape Editor topic.


An error message is displayed and the item is not saved if the user does not select a compatible token for the target, or define the correct token for each target when they try and submit the item.

An error message is displayed if the user selects Advanced under Scoring Rules and clicks (+), but does not select any Target under Combination.

You must define a minimum of one token and one target in an Enhanced Matching item type. You may define multiple tokens and only have one target in the item. The various Tokens become distractors for candidates and they must select the correct Token in order to correctly answer the item.

If you do not define scoring rules for a target, an error message notifies you that each response target must have at least one correct token.


Scoring Rules

You can set the scoring for the items based on the Targets combination. There are two ways to set the combination by following two rules listed below.

    • Basic Scoring: All Targets are considered for the scoring, thus all Targets and Tokens must match correctly for the candidate to score this item as correct.
    • Advanced Scoring: Scoring rules are set in this tab by clicking the  Add Scoring Rules icon provided to add new rules. Three columns are present here:

      • Rule No: This is the rule number. This starts with 1 at the top and increments by 1 as more rules are added below.
      • Combination: This lists all the Targets in a drop-down list with each Target having a corresponding check box for selection. The user can select a combination of Targets that must be answered correctly for the candidate to score according to the current scoring rule.
      • Item Score: This is an input field to specify the score value to be awarded to the candidate upon correctly answering the Target combination for the corresponding rule.

Rules can be added by clicking the Add Scoring Rules icon and removed by clicking the Delete Scoring Rules icon.


When setting the advanced scoring rules, users can configure "Add" or "Set". The add option sums up the scores on the rules for the item. These values are displayed in the minvalue and maxvalue attributes in the QTI output. The set option allows users to configure the minvalue and the maxvalue in the QTI output. These options identify the maximum and minimum number of points the candidate may get if they answer the item correctly or incorrectly.

When users select "Add", the maxvalue in the QTI output is a sum of all the correct options for the item.

When users select "Set", the maxvalue attribute in the QTI output is the highest value from the options in the item.

Users can configure negative scoring for both "Add" and "Set".

When all the item scores are positive values, the minvalue attribute in the QTI output is set to zero.

When users select "Add", the minvalue attribute in the QTI output is a sum of all the negative values from the options in the item.

When users select "Set", the minvalue attribute in the QTI output is set to the lowest negative value from the options in the item.


The Templates button allows a user to save attributes for Tokens, Targets, Labels, and Scoring Data.

  1. Click the Templates button. A Manage Templates window opens, which lists existing Enhanced Matching Item Templates from the current Item Bank and the DT Item Bank. This window also allows the user to create a template from an existing item or an item being created, or applies an existing template to an item.
  2. Select the desired template in the list and click the Apply button.
  3. A pop-up window opens to confirm whether you want to apply the selected template to the item.

    • OK button: Apply Tokens, Targets, Labels, Scoring and Background image parameters from the selected template to the item, close the pop-up, and return to the Manage Template window.

      A new item titled Last Applied Template Name appears on the page at the same level as Load Template, and the name of the applied template appears in front of it.

    • Cancel button: Cancel application of the template, close the pop-up, and return to the Manage Template window.

      You will lose all contents of the item when you click Cancel, as it is replaced by the selected template contents when you apply a template. The lost content, cannot be retrieved.

      Visit How to Work with Enhanced Matching Item Templates to learn more about Enhanced Matching Item Templates.



You can click the Submit on Behalf of drop-down control and select one of the user names in the list to submit an item on behalf of the selected user. The user list contains names of users enabled in the current project, except the user currently logged in and viewing the list. The list is displayed in ascending order by last name, first name, and user name. Once you click the Submit button, the item is saved to the Draft mode and does not show for the current user.


Submit on Behalf of drop-down list is not available at the time of Modify Question.


Click the Check Spelling link to check spelling for text in Stem and Options. The spelling is checked first against the built-in or installed dictionary and then against the words specified for exclusion on the Dictionary tab of your project's settings.

Keep in mind that for users to write this type of item, it must be enabled on the Questions tab of the project's Configuration page. From Manage → Settings → Configuration → Questions → Allow Question types, select Enhanced Matching from the list and click Update. If you do not see this type of item in the drop-down list, please contact your Project Manager to change the project settings.



  • No labels