What is a merge string, and how do I use one?

A merge string is a placeholder inserted into a Word report template that the system replaces with real data when a feedback report is generated. Merge strings are how all dynamic content reaches the report, including respondent details, scores, ratings-based text, charts, tables, and the answers a respondent selected.

For example, a merge string in a template might be a placeholder for the respondent's name, the score they achieved for a section, a chart of their results, or a block of conditional text based on their rating. When the report is generated, each merge string is substituted with the corresponding content for that specific response.

How to insert a merge string into a Word template:

1. Install the Merge Manager Word Add-In in Microsoft Word.
2. Open your Word report template.
3. Open the Merge Manager from the Word Home ribbon and sign in with your Brilliant Assessments site code and credentials.
4. Select the assessment the report is for.
5. Position the cursor in the template where the merge string should appear.
6. Use the Merge Manager panel to insert the desired merge string - for example, a chart, a score, a ratings-based text block, or a response field such as the respondent's name.
7. Save the Word template, upload it to the assessment, and generate a test report to confirm the output.

Merge strings are case-sensitive and must match the names defined in the Merge Strings Library exactly. A typo in a merge string causes blank output or an error message. Using the Merge Manager to insert merge strings rather than typing them manually avoids this issue.

For full details, see Merge Strings Library for Reports and Results and Using the Merge Manager Word Add-In.