Linking Assessments to Program Enrollments
Learn how to link an assessment recorded at the agency level to an active program enrollment, and how to unlink it, in Clarity Human Services.
Table of Contents
Overview
Users can link an existing agency-level assessment to an active program enrollment.
In the client's program enrollment, the Program assessments header in the Assessments workspace has an Action Menu (three dots) icon with a Link from Assessment option.
- If they have an access role that allows them to modify the client program.
- If there is an assessment available to link.

Note: You can only link assessments recorded at the same agency as the enrollment. Ensure that you are switched into the correct agency, and that the same agency provided both the assessment(s) and enrollment.
What System Administrators need to do: For an assessment to be available to link, a System Administrator must complete both of the following in the program's setup. These steps are required.
- Enable the Program Assessments setting.
- Add the assessment under Program Resources > Program Assessments.
If these steps are not completed, no assessments are available to link, and the Link from Assessment option does not appear. For setup steps, refer to How to Set Up a Program: Detailed Instructions.
If the user does not have the appropriate access or there is no assessment to link, the user will not see the action menu icon with the option to “Link from Assessment.”
Linking Assessments
When the user clicks the “Link from Assessment” option, a panel opens up on the right side of the screen titled “Link from Assessment.”
The panel will have two columns:
- “Name” - Assessment Name
- Users can sort the list alphabetically by Assessment Name.
- “Date Completed” - The date the client completed the assessment
- There is a default sort to display the most recently completed assessments first.

For Assessments that have been marked as “Private," a Privacy (lock) icon displays.

The panel displays only assessments that are not linked to the current enrollment.
To link the assessment, the user can select the checkbox to the left of each displayed Assessment row, then click Save.
Note: The workspace displays any assessments the client has completed in a different program within the same agency as the current program enrollment, as long as the assessment type is enabled for the current program.
Unlinking Assessments
Users can unlink an assessment from an active program enrollment. This option will only appear for users with the Delete Agency Assessment or Delete Any Agency Assessment access right enabled. Refer to Rights Glossary for Access Roles.
Next to each assessment on the list, “Unlink from Program” appears in the action menu for users with the appropriate access and for assessments linked to a program.

Click Confirm to unlink the assessment from the program enrollment, or Cancel to keep it linked.
The pop-up reads: “Are you sure you want to unlink [assessment name] assessment from [program name that the assessment is linked to]?”

When the user clicks Confirm, the assessment will be unlinked from the program enrollment.
Note: Unlinking an assessment from the program does NOT delete the assessment; it only deletes the program linkage.
Icons & Tooltips
|
Icon |
Icon/Tooltip Name |
Tooltip |
Icon Location |
|
|
Action menu, also known as:
|
"Show more actions" |
All Screens: typically on the far right of a screen or section. |
|
|
Column Selector |
"Show/hide fields" |
All Screens: typically paired with a search bar |
|
|
Confirm Unlink |
(no tooltip) |
Shown on Unlink Confirm popup |
|
|
Link from Assessment |
(no tooltip) |
Action Menu: on a program enrollment's Assessments tab |
|
|
Save |
(no tooltip) |
Shown on Link from Assessments panel |