Customize feedback comments for short response rubrics

Feedback Aide lets you customize the feedback comment it generates for responses evaluated with a short response rubric type, so the comment matches your teaching style and classroom context. You control three aspects of the comment: whether it reveals the correct answer, whose point of view it is written from, and any extra instructions you want it to follow.

Control Option Values What it changes
Cueing feedback.cueing reveal, guiding Whether the comment states the missing or correct answer
Point of view feedback.point_of_view second_person, third_person, passive Who the comment addresses or describes
Feedback guidance feedback.guidance_text Free text What the comment focuses on, plus any other instructions

These controls change only the wording of the feedback comment. They do not change the score Feedback Aide awards.

Cueing

Cueing controls whether the feedback comment tells the learner what their response is missing. Set feedback.cueing to one of the following values.

  • reveal: the comment names the missing or correct content directly. Use this when learners need the answer to move on, for example in revision or review activities.
  • guiding: the comment points out where the learner went wrong, but does not expose the missing answer. Instead, it prompts the learner to work it out. Use this for formative practice where you want learners to try again.

For example, a learner is asked to name the four components of blood and answers "red blood cells and white blood cells".

Value Example feedback comment
reveal You correctly identified red and white blood cells. You also needed plasma, which carries dissolved substances, and platelets, which help blood clot.
guiding You've covered the cells that carry oxygen and fight infection. What do those cells travel in? And what helps you stop bleeding when you cut yourself?

With guiding, the comment does not mention plasma or platelets, even though Feedback Aide knows they are missing.

Point of view

Point of view sets the grammatical voice of the feedback comment. It changes how the comment is phrased, not what it says. Set feedback.point_of_view to one of the following values.

Value Writes the comment… Example feedback comment
second_person To the learner, using "you" You correctly identified red and white blood cells, but you left out plasma and platelets.
third_person About the learner, using "the learner" The learner correctly identified red and white blood cells, but left out plasma and platelets.
passive Without referring to a person Red and white blood cells are correctly identified, but plasma and platelets are missing.

Use second_person when learners read the feedback directly. Use third_person when the feedback is mainly for teachers or graders. Use passive when you want a neutral, impersonal tone.

Feedback guidance

Feedback guidance is a free-text field for your own instructions about the feedback comment. Use feedback.guidance_text to tell Feedback Aide what to focus on, or how to write the comment, in plain language.

Examples of feedback guidance:

  • Focus on the use of correct scientific vocabulary.
  • Keep the comment to two sentences or fewer.
  • Remind the learner to include units of measurement.
  • Use simple language suitable for learners aged 10 to 12.

Write each instruction clearly and keep it specific to the feedback comment. Feedback guidance shapes the comment only; it does not change how the response is scored. To change scoring, edit the rubric or grading options instead.

How the controls work together

You can use any combination of the three controls. When feedback guidance conflicts with cueing or point of view, the structured setting takes priority and Feedback Aide ignores the conflicting part of the guidance.

Structured setting Conflicting feedback guidance Result
cueing: guiding Always give the learner the correct answer. The comment does not reveal the missing answer.
point_of_view: third_person Speak directly to the student as "you". The comment refers to "the learner".

Instructions in the guidance that don't conflict still apply. For example, with guiding and the guidance "Focus on scientific vocabulary", the comment both withholds the answer and focuses on vocabulary.

Effect on the score

None of these settings affect the score. Feedback Aide grades the response in the same way regardless of cueing, point of view or feedback guidance; only the wording of the feedback comment changes.

Configuring feedback customization

Set the controls in the feedback object of the Feedback Aide evaluation options, through the JavaScript API.

Was this article helpful?

Did you arrive here by accident? If so, learn more about Learnosity.