Advanced Assessment Question: Token Highlight

The Token Highlight question requires students to highlight certain words, sentences, or paragraphs by clicking on the text.

Monica Burke avatar
Written by Monica Burke
Updated over a week ago

Now that you've started to build an advanced assessment, you may want to add a Token Highlight question.

➡️ Need help getting started with Advanced Assessment first? Click here

The Token Highlight question requires students to highlight certain words, sentences, or paragraphs by clicking on the text.


Article Table of Contents:

Build the Question

If you are creating a new item, select the + Create button on the assessment builder, title the item, then select the Add New plus sign to add a question.

If you are adding to an existing item, simply select the Add New plus sign (as shown above) to add a question to the item.

Next, select the Highlight and Drawing category from the options on the left, then select Token Highlight.

➡️ Step 1: Compose Question

  • Type the stem of the question in this field.

  • You have many formatting options from the Rich Text toolbar, including changing the font size, adding tables, using math symbols, adding multimedia, and more! Click here for more information on the different functions of the Rich Text toolbar.

➡️ Step 2: Edit Template

This is where you type the text that the students will interact with.

➡️ Step 3: Determine Clickable Text

1️⃣ Tokens

  • Tokens = Clickable Text

  • When you select Edit Token, you are determining what parts of the text the students will be able to select. "Tokens" stand for the number of clickable components the students will have. In the example below, there are 58 tokens, which means there are 58 words the students can select.

Note - this is NOT where you determine correct answers; this is only where you are designating the clickable components for students.

  • The student will be able to select anything that is highlighted in blue.

  • Deselecting any portion of the text removes the student's ability to select that text when they answer the question (see example below). Notice how the words not highlighted in blue are unable to be clicked by the student.

Student example:

2️⃣ Grouping Tokens

  • There are three primary options when grouping tokens; sentence, paragraph, or word.


If you want the clickable text to be entire sentences. In the example below, there are 7 tokens (7 sentences) for the students to click.


If you want the clickable text to be entire paragraphs. In the example below, there are 3 tokens (3 paragraphs) for the students to click.


If you want the clickable text to be individual words. In the example below, there are 6 tokens (6 words) for the students to click.

  • It is also possible to create custom tokens by highlighting any text that does not already have a token applied. You can either clear all tokens and select the words you would like to apply the token to, or you can click existing tokens to deselect them before highlighting the words or sentences that you want to group together.

3️⃣ Things to consider:

  • Selecting Clear will reset your tokens; you will then need to choose your token grouping again to make the text clickable.

  • Each time you choose a different token grouping, you will see this message. This is telling you that your current selections and any answers you may have set will be cleared and need to be redone.

Set Correct Answers and Scoring

➡️ Set Correct Answers

Once you have finished editing your tokens, you can now determine the correct answers.

  • Under the Select correct answer(s) section, click the paragraphs, sentences, or words that are the correct answers (the components the students should click in order to get full credit).

  • In the example above, if the student clicks I, We, and you, they will be awarded full credit.

➡️ Scoring

  • Choose how many points you'd like the question to be worth.

  • If you have auto-scoring enabled, you'll have to choose Exact Match, Partial Match per Response, or Partial Match. Using the example above, here is a description of how each will work:

Exact match: the entire question must be answered correctly to receive the point(s).

  • In this example, students will need to select all of the correct answers (I, We, and you) in order to get the full point. There is no partial credit when choosing this option.

Partial Match per Response: each selection is scored independently, and each is worth the number of points indicated in the point(s) field.

  • In this example, each correct selection would be worth 1 point, making the entire question worth 3 points total. For example, if the student selects I, We, and him, the student will earn 2/3 points.

Partial Match: similar to partial match per response, each selection is scored independently, but the point value indicated in the point(s) field is evenly split among the number of options.

  • In this example, each correct selection will earn 0.33 of a point. For example, if the student selects I, We, and him, the student will earn 0.66/1 point.

💡 Tip from the Otus Team: For details on the other optional scoring settings, such as penalty points, see the More Options section below.

Student Preview

It's highly recommended to Preview the question before adding it to the assessment. This displays the question as the students will see it and also verifies that the answers and scoring work as expected.

  • Step 1: Select the Preview button to go into Preview mode.

  • Step 2: Answer the question with the correct answers, including alternates.

    • Selecting Show Answers will present the correct answers.

  • Step 3: Verify that the auto-score correctly calculates the point value.

Here is a short clip of this question type from the student's perspective.

➡️ Want to preview the entire assessment? Click here for details.

More Options

➡️ Other Scoring Options:

  • Unscored/Practice usage: removes all scoring from the item.

  • Check answer button & Check answer attempts: find more information here!

  • Penalty points: use this option if you want students to lose points for giving incorrect answers.

  • Minimum score if attempted: student will receive points as long as the question has been attempted (if the question is left blank or is unanswered, the student will not earn those points).

➡️ Layout and Selection Options:

  • Change the font size: In the Font size dropdown menu, you can change the font size of all components of the question to small, normal, large, extra large, or huge.

  • Max selection: you may want to designate a maximum number of tokens the student can select. For example, if you don't want them to be able to select more than 3 tokens, add the number 3 to this field.

Learnosity Resources

Next Steps

Copyright © Learnosity Ltd. 2006-2022

Did this answer your question?