Client Records and Households

How Do I Create a New Client Record?

This article explains how to enter a client's information and photo into Clarity Human Services.

 

Note: If the client is a domestic violence survivor, follow your community's procedures for entering their information into the system.

If you search for a client record and do not find it in the system, click ADD CLIENT on the SEARCH FOR A CLIENT page to create a new record.


From the CREATE A NEW CLIENT page, you’ll record core data about the client. The fields displayed here are based on the Client Profile screen assigned to the agency (or based on the Client Profile screen assigned to the staff member, if a system administrator has used the Profile Override  setting to assign a Client Profile screen other than the Agency Default to that staff member). 


Certain fields are required before you can save the record. If a required field is left blank, the system displays a banner to indicate that the record cannot be saved.  

 

Note:  To assist with data entry, if you enter 000-00-0000 for the Social Security Number field value, the Quality of SSN field will auto-populate with “Client doesn’t know.” You can update this value as needed. Similarly, since the HUD Data Standards only require users to enter a value for the Date of Birth field when certain Quality of DOB field selections are made, the Quality of DOB field is listed first; the selection you make for the Quality of DOB field will then determine whether the Date of Birth field remains on the screen:

  • If you select “Full DOB Reported” or “Approximate or partial DOB reported,” the Date of Birth field remains on the screen for you to complete.
  • If you select “Client doesn’t know,” “Client refused,” or “Data not collected,” the Date of Birth field will disappear from the screen.


If the assigned Client Profile is customized locally, it may also contain fields that aren’t required. 

One of the fields that may be included on this screen is the Alias field. If the client is known by other names, you may enter them in this field, separated by commas.

If the Pronouns field appears on the screen, you can make a selection from the drop-down menu.


If you do not see the client's pronouns listed, you may select "Manual Entry" and use the Pronouns Manual Entry field to enter custom pronouns for the client.

The client's pronouns will appear in parentheses after the client's name in all locations throughout the system where the client's name is displayed.

image-20221117-144240

  • If you choose “Select,” “Client doesn’t know,” “Client refused,” or “Data not collected,” no pronouns will be displayed.
  • If you select "Manual Entry" but do not enter any text in the Pronouns Manual Entry field, no pronouns will be displayed.

Completing the Release of Information

Whether a Release of Information is required for record creation depends on the system and agency-level settings. If a Release of Information is required, the system will display Please fill in Release of Information form at the bottom of the screen. When the ROI record has been completed and saved, the ADD RECORD button will appear. For more information, see Release of Information Overview

After completing all necessary fields, click ADD RECORD at the bottom of the page to create the client record. 

Unique Identifier

The system displays the client’s Unique Identifier on the right side of the screen. Hovering over this icon displays a tooltip with the client’s Personal ID (used for identifying duplicate client records within Clarity Human Services).

personal ID-1

The Personal ID is a 32-character mix of numbers and letters that does not contain the client’s Unique Identifier, does not contain any Personal Identifying Information (PII), and is not a duplicate of a Personal ID that is already in use.

Note:  When a client record is created, recovered, or updated, the system will search for any client records with PII that exactly matches the PII in the new/recovered/updated record but have a different Personal ID.  If matching records are found, the system will deduplicate those records by updating the Personal ID of the new/recovered/updated record to the Personal ID of the matching record.

Community Queue/Program Referral Alert

After the client record is created, any referrals that are made to a program or to a Community Queue for the client will be listed under the client's Unique Identifier. Click VIEW DETAILS to view the referral.

alerts

Adding a Photo

To add a photo to the client record, hover over the default Client Profile image and click UPDATE PROFILE PHOTO

If you are taking a photo using a webcam, you may need to grant the site access to your camera in your browser.

If you’re uploading a file, the acceptable file formats are .gif, .jpg, .jpeg, .png, and .tiff, and the maximum file size is 4 MB. 

Updated: 03/04/2024