Author items

The process of authoring an item involves writing the item content, indicating the correct responses, applying formatting, and adding images, media, or exhibits. Items are also assigned to a blueprint area, and details such as metadata and references are sometimes required.

Launch video in a new window >>

Start a new item

  1. On the Assignments page, you'll see a list of your assignments for the project with the following columns displayed:
    1. Criteria: The name of the project's assignment criteria (such as blueprint areas or metadata) that you have been assigned to. Note You can review the project's blueprint (if available) by clicking the View blueprint button. 
    2. Assigned: The total number of items you have been assigned to write for each criteria. 
    3. Remaining: The number of items assigned to you in each criteria and are not yet submitted. (E.g., if 15 items were assigned and you already submitted two, the Remaining number should be 13.)  
    4. Due Date: The date when all items must be written and submitted by for each criteria.
  2. Make sure you are on the Writing tab. (If you are also a reviewer, you'll see both a Writing tab and a Reviewing tab.)
    1. If your project uses Item Assist, you'll see the Item Assist button. Learn more about generating items with Item Assist here
  3. Click one of the following options to start a new item:
    1. Click Edit for a particular assignment. 
    2. Click Write item to author a new item that is not part of a particular assignment. (Assignment criteria won't automatically be applied. Make sure to apply the required blueprint area and/or metadata to the item before submitting it.) 
  4. The item editor opens. The default item type for the project is presented by default.

Choose an item type

  1. Choose an item type from the drop-down list at the bottom of the page. 

Note Only items that the item bank manager has enabled will be available in the Item type list when authoring an item.

Note If you change the template (e.g., from Multiple choice to Drop down) after adding content, some content may be lost. Make sure to copy and store any content that you don't want to lose before switching the item type. 

Write the item content

  1. Write the main content of the item, such as the stem or question. Steps vary depending on the item type

Additional item content options

Note Some options may not be available for certain items. 

Choose correct responses

  1. Select the correct response (or responses) as if you were a candidate answering the item. Steps will vary depending on the item type

Assign blueprint area

The blueprint is used to classify items when building exams. (Note: The blueprint area may already be assigned to the item, depending on which assignment you opened from your dashboard page.) 

  1. In the item settings panel , click Blueprint.
  2. Select a DomainTask, or Sub-Task as appropriate for the item.  
  3. Click Save in the lower-right corner of the page. 

Learn more about blueprints

Add metadata

Metadata is used to classify items for reporting and searching purposes. It can also be exported in exam QTI. 

  1. In the item settings panel , click Metadata
  2. Enter text or select options based on the available fields. 
  3. Click Save in the lower-right corner of the page.

Learn more about metadata

Add item enemies

When two or more items are 'enemies', they cannot be included in the same exam form (unless the person building the exam manually overrides the restriction). 

  1. In the item settings panel , click Enemies
  2. In the Add enemy text box, enter the Question ID  of the item that you want to associate as an enemy. Click View if you want to preview the item first. 
  3. Click Add
  4. Click Save in the lower-right corner of the page to save the item. 

Learn more about item enemies

Add references

Document source materials that you referenced when writing item content. 

Note When you create and save a new reference, that reference is added to the project's reference library and can be applied to other items. 

  1. In the item settings panel , click References.
  2. Select an option from the Type drop-down menu (e.g., Book). 
  3. Click inside the Reference field and select an existing reference (if available) or Create a new reference.
  4. Enter information for the various fields (described below).
  5. Click Add in the lower-right corner of the References panel. 

Learn more about references

Choose delivery settings

Note Some fields may be read-only or not visible. Whether certain settings can be edited is based on permissions set in the item type template. 

  1. In the item settings panel , click Delivery settings. (If you don't see this panel, it is likely not enabled for the item type.)
  2. Select or edit properties as needed (if the field is editable).  
    1. Title: Enter an item title, which displays on the item review screen during exam delivery (only if idents are hidden and Display title (see below) is set to True). (A default title may be already applied; if you change the title it will only affect the current item.)  
    2. Display title: Determines if the item's Title (see above) is displayed on the item review screen during exam delivery. Select True to display the title during exam delivery. Select False to hide the title during exam delivery; it will only be visible in ExamDeveloper. If you select Not set, no QTI values for this setting will be exported.
    3. Calculator: Determines which, if any, calculator types are available with this item during exam delivery. Choose a single type or combination of types including Standard, Scientific, and/or Graphing (see example image below). Availability of calculator types depends on the item type template settings. If you don't want to change the calculator type, choose Not set (the parent section settings will be used if present; if parent values are not present, no QTI settings for the calculator will be exported).
      1.  Note If you add a calculator to an item, you must add the calculator to the Exam Level or you will receive a QTI Compilation error. See the PearsonvueApplication (Calculator) topic for details on adding calculators to the exam level."
    4. Enumerated: Determines if the item is excluded from the numbering sequence in the review screen. Select True to exclude it, or select False to include it. If you select Not set, no QTI values for this setting will be exported. About enumerationAbout enumeration

      By default, all items are numbered in the review screen. When you exclude an item from numbering, the next item in the list uses the subsequent numbering. For example, if the first item is excluded from the numbering; the second item is assigned the value of 1. If the fifth item is also excluded from the numbering, the sixth item is assigned the number 4.

    5. Shuffle response: Determines if the shuffle response feature is enabled for this item. Select Yes to enable shuffled responses (response options will be displayed in a random order) or select No to disable shuffled responses (response options will always be displayed to candidates in the same order - which is the order specify when authoring the item). If you select Not set, no QTI values for this setting will be exported.
    6. Response required: Determines if the candidate must enter a complete response for the item before navigating away from it. Select True to require a response (a message is displayed if the response is incomplete or unanswered, and the candidate is unable to proceed) or select False to allow candidates to proceed without answering the item completely. If you select Not set, no QTI values for this setting will be exported.
    7. Response confirmation: Determines if candidates will be prompted to confirm their answer to an item before navigating away from it. This is often used for exams that don't allow candidates to go back to an item once it has been answered. Select True to enforce the confirmation prompt or select False to disable the prompt and allow candidates to proceed without confirming.  If you select Not set, no QTI values for this setting will be exported. 
    8. No response confirmation: Determines if candidates will be prompted to confirm their answer to an item before navigating away from it, only if the response is missing or incomplete. Select True to show the confirmation prompt or select False to disable the prompt and allow candidates to proceed without confirming.  If you select Not set, no QTI values for this setting will be exported.
  3. Click Save in the lower-right corner of the page. This saves all changes made to the item.  

Add comments

Comments are used for internal communication between item authors and reviewers (this feature is NOT related to comments that can be entered by candidates during exam delivery).

  1. In the item settings panel , click Comments
  2. To enter a new comment, choose a type from the Flag drop-down menu. This flags the comment by subject, issue, or category. Flags are configured by the item bank manager. 
  3. Enter comments in the Comment text field. If desired, you can apply basic formatting to the text or insert assets, tables, and equations. 
  4. Click Add

You can view older comments left by other authors or reviewers beneath newly added comments. 

Learn more about comments

Save the item

Save the item to work on it later. This places the item in a Draft state. 

  1. Click Save in the lower-right corner of the page.
  2. A confirmation is displayed when the item is successfully saved.

Note The first time you save the item, the item ID is generated and displayed in the lower-left corner and in the item header. You may want to take note of the item ID in a separate location. 

Preview the item

Preview the item using a sample browser-based test driver (Exam Preview). This shows how the item will appear to candidates during exam delivery. 

Note Items with media can only be previewed if the media files are hosted in the Media Content Deployer application and an Item preview template is used where embedURI = false and the correct folder path of the files in Media Content Deployer is specified.

  1. In the lower-right corner of the page, click Save . (You must save the item before previewing it.) 
  2. Click More > Preview.

The item preview will launch in a new tab or window in your browser. 

Submit the item for review

Submitting an item sends it to the next assigned reviewer or stage in your project workflow. You will no longer be able to edit this item unless it is sent back to you. 

  1. Click Submit in the lower-right corner of the page.
  2. A confirmation is displayed when the item is successfully submitted.

Track submitted items

If the project manager allows it, you can track the status of submitted items on your dashboard by clicking the Submitted tab. Review states will vary by organization, but will typically be categorized as 'still in review' or 'completed' (approved and advanced to next review stage). 

  • Review states: the item is still being reviewed. Note this tab does NOT show items that were returned by the reviewer; returned items will appear in the Returned queue on your dashboard page.  
  • Completed states: the reviewer approved the item. This means you can no longer edit it. 

Note: sparkle is shown next to any submitted items that were generated or refined using Item Assist.  

Write another item

You can start authoring a new item for the same project without returning to your dashboard. 

  1. In the lower-right corner of the page, click More > Cancel
    1. This places the item in 'view' mode and changes the options in the More menu.
  2. Click More and select Write new item
  3. A new item is opened for editing. (The default item type is initially selected.)

Work on a different assignment

Click the Return button in the top left corner. This takes you back to your Assignments page.