How do I show different text in the report based on a respondent's score?

To display different feedback text depending on a respondent's score, use Ratings-Based Text. You define a set of rating bands (for example, Developing, Competent, and Advanced), write feedback text for each band, and the report automatically displays the text for the band the respondent's score falls into.

The same set of bands can drive different text at the assessment, section, subsection, and segmentation levels. Follow the steps below to set this up.

Step 1: Set up your rating bands

1. Go to Assessment Settings > Ratings.
2. Click Add Rating to create a band, or Edit to change an existing one.
3. For each band, enter a Rating Name (for example, "Needs Development", "Good", "Excellent") and a Maximum Score.

The Maximum Score is the top of that band, entered as a whole-number percentage (for example, 49 means 49%). The next band up implies the minimum, so a respondent who scores 65% falls into the lowest band whose maximum is above 65%. For example:

• Needs Development - Maximum Score 49
• Good - Maximum Score 74
• Excellent - Maximum Score 100

A score of 65% lands in "Good"; a score of 82% lands in "Excellent".

Step 2: Enter the rating text at the level you want

Write the feedback text at whichever level you want it to appear in the report. You do not need to use every level.

For assessment-level text (overall result):

1. Stay in Assessment Settings > Ratings.
2. Open each rating band and enter the feedback text in the Rating Text editor for that band.

For section-level text:

1. Go to the Assessment Builder and open the Section you want.
2. Click Edit.
3. Select each rating band in turn and enter the feedback text for that band.
4. Repeat for each section that needs rating text.

Subsection and segmentation text work the same way: open the Subsection or Segmentation you want to edit, then enter the feedback text against each rating band.

Step 3: Insert the merge string in your Word template

In your Word report template, insert the rating text merge string at the position where the feedback should appear. The merge string depends on the level:

• Assessment level: {Rating.RatingText[]}
• Section level: {RatingSection.RatingText[SectionNo=2]} (replace 2 with the section number)
• Subsection level: {RatingSubsection.RatingText[SectionNo=2]}
• Segmentation level: {RatingSegmentation.RatingText[SegmentationNo=1]}

Step 4: Generate a test report to confirm

Generate a report from a test response and check that the correct text appears for the score achieved. Test responses at different score levels to confirm each band displays as expected.

Full step-by-step detail

For the complete walkthrough, including where to find the Rating List, how to edit a rating, and how to apply rating text at the section, subsection, and segmentation levels, see Managing Ratings and Rating Scales.

For the full set of rating text merge strings and their parameters (Top/Bottom, Role, Iteration, and Advanced Rating Types), see Configuring Ratings-Based Text.