Reading and review merge fields pull reviewer assignments, scores, reading progress, and comments from the Online Review module into letter templates or other content to create candidate review summaries.
💡Quick Answers
- What standard review merge fields are available? {{contact.review_readers}} (assigned readers), {{contact.review_reading_status}} (complete or incomplete), {{contact.review_comments}} (per-reader comments), and {{contact.review_overall_score}} (combined review percentage).
- How do I find the merge field for a specific rating criteria score? Use the format {{contact.review_[criteria_name]_score}}, e.g. {{contact.review_social_fit_score}}; locate exact names in the Merge Field Picker under Contact > Review.
- What does review_overall_score calculate? It converts each reader's score to a percentage based on the criteria scale, then averages those percentages across all assigned readers.
- How do I build a full candidate read sheet with these fields? See Creating a Review Committee Read Sheet Summary for a step-by-step letter template guide.
How-To
Merge fields can be added to a template through the Merge Field Picker or by typing/copying them directly into the body of the template. Learn more in our 'How to Pull in Dynamic Information' section here.
In the merge field picker, once you have selected the Contact category, you can find all the reading and review merge fields under the subheader of Review.
Below are some of the standard review-related merge fields:
Assigned Readers
Displays the list of readers assigned to the student, comma-separated.
- Merge Field: {{contact.review_readers}}
- Example: Shelly Reader, Steve Reader
Reading Progress
Displays a value of 'complete' or 'incomplete' depending on if all assigned readers have completed their review of the student or not.
- Merge Field: {{contact.review_reading_status}}
- Example: incomplete
Reader Comments
Displays the comments that each reader has written for each of the checklist items in review.
- Merge Field: {{contact.review_comments}}
- Example:
Review Overall Percent
Displays the combined review percentage score for the student. To get this percentage, the system converts each reader score to a percentage based on the scale for that criteria and then averages those percentages together.
- Merge Field: {{contact.review_overall_score}}
- Example: 87.5%
Rating Criteria
There are also some additional merge fields to pull the individual scores based on the Rating Criteria that your school has configured.
The specific merge fields will depend on the names given to your rating categories, but they will all follow the basic format of {{contact.review_[Review Category Name]_score}}. For example, if you have a rating category for Social Fit, the merge field to pull its score will be {{contact.review_social_fit_score}}.
You will also be able to locate the review score merge fields in the merge field picker. The format will always be "Review Score for [Review Category Name]". Example:
These scores will output as a number formatted with two decimal points (e.g. 4.50).
Comments
0 comments
Article is closed for comments.