Data Import Tool (DIT) Sample Files

Common Import Scenarios

These sample files cover common import scenarios:

• Simple CSV data set: contains sample clients and enrollments at five different projects. Includes enough data to allow for Program and Services mapping. 
• Minimal HMIS CSV File (one enrollment record): contains a single sample client with a single enrollment. It also contains the requisite project record, necessary when there is an enrollment record included. 
• Clarity XML Unique Identifier: XML file demonstrating how to make an external client record match with an already existing Clarity Human Services client record, using the client's unique identifier.
• Clarity XML Custom Fields: XML file that includes custom Client Profile fields, as well as custom fields for enrollment, exit, status update, and annual assessment.
• Clarity XML Single Client: XML file that contains only one client record to illustrate what a minimal XML file might look like.

Support for CustomClientGender.csv and CustomEnrollmentSexualOrientation.csv Files

The cross-vendor CustomClientGender.csv and CustomEnrollmentSexualOrientation.csv formats will import into the preexisting gender and sexual orientation Clarity Core fields, using the Data Import Tool (DIT).

The two new CSV files must be zipped together with the rest of the standard FY2026 HUD HMIS CSV files in a single zipfile.  The new files must have  ExportIDs, EnrollmentIDs, and ClientIDs that match those found in the rest of the zipfile set.

Users with access to validation and import results will be able to view the following:

• Validation results prior to importing CustomClientGender.csv and CustomEnrollmentSexualOrientation.csv.
• Import results for CustomClientGender.csv and CustomEnrollmentSexualOrientation.csv.reflect data import issues encountered.
• Audit logs for any changes made to gender and sexual orientation values after successful import.

Format for the extension files:

• HMIS CSV Extension for Custom Gender FY2026: The goal of this extension is to provide a bulk means of transferring client gender details that have been removed from the FY2026 HMIS definition. 
• HMIS CSV Extension for Custom Sexual Orientation FY2026: The goal of this extension is to provide a bulk means of transferring enrollment-level sexual orientation details that have been removed from the FY2026 HMIS definition. 

Sample CSV file:

• FY2026 CSV with Additional Gender and Sexual Orientation Files.

Updated: 02/13/2026