HUD Connect Release Notes
Review all HUD Connect release notes here!
Table of Contents
HUD Connect is updated separately from HomeKeeper. Each version is located in a separate tab which includes the upgrade link, a list of all changes, and any action required on your part to complete the upgrade. See the chart at the bottom for which version of HUD Connect runs on which version of HomeKeeper.
NOTE: HUD Connect is an additional app that works on top of the HomeKeeper package, to enable 9902 reporting. If your program is interested in acquiring HUD Connect to report housing counseling data to HUD or another intermediary, contact HomeKeeper support for pricing & setup information.
HUD Connect 1.12 (Spring 2025)
WARNING: Prior to upgrading to HUD Connect version 1.12, you must also upgrade HomeKeeper to version 2.14. See Release Notes for 2.14 here.
Updates to HUD Connect:
- Three new fields have been added to the Submission Log record: Fiscal Year, Fiscal Quarter, and Fiscal Quarter End Date.

- Previously, users had to click ‘Update HUD Submission Log’ to view the updated status after submission. Now, the status will update automatically 15 minutes after submission.

Technical changes and bug fixes:
- We corrected an issue where presubmission reports were auto-populating incorrect quarter dates.


How to upgrade your HUD Connect to version 1.12
While logged into Salesforce where your HUD Connect app is installed, click this link to upgrade to version 1.12 of HUD Connect.
(Note: If you are installing into a sandbox organization, replace https://login.salesforce.com/ with http://test.salesforce.com)
Previous Versions of HUD Connect
HUD Connect 1.11 (Summer 2024)
We held a Release Webinar on August 20th, providing a live demo of the Applicant Info feature and reviewing context around each of the features listed below that are released as part of HomeKeeper v2.13 and HUD Connect v1.11. Click here to download and watch the recording!
Prior to upgrading to HUD Connect version 1.11, you must also upgrade HomeKeeper to version 2.13.
Updates to HUD Connect:
- We have updated 9902 reports and submissions to include Gender, as it is a field required by HUD. When submitting your 9902 XMLs, you should see Gender included where it has been added for a client and is also reflected on the Service File, Primary Applicant Gender.
We have updated 9902 reports and submissions to include Agency UEI in HUD Agency submissions.
Technical changes and bug fixes:
- We identified an issue with counting purpose of visits when populating the 9902. HUD Connect will no longer count the Purpose of Visit for Group Education C/Es - even if it's set on the CE.
- We identified a bug where HUD Connect was referencing the incorrect Agency ID, and have fixed it.
- HUD has officially changed submission URLs for ARM 6, and so we have updated our submission URL to reflect that.
How to upgrade your HUD Connect to version 1.11
While logged into Salesforce where your HUD Connect app is installed, click this link to upgrade to version 1.11 of HUD Connect.
(Note: If you are installing into a sandbox organization, replace https://login.salesforce.com/ with http://test.salesforce.com)
HUD Connect 1.10.1 (patch update, Winter 2023)
This version of HUD Connect corrected the newly added Presubmission Client Report in version 1.10, which was showing incorrect records for Client submission data to HUD due to a filtering error.
HUD Connect 1.10 (Winter 2023)
If you are a HUD Connect user and you are upgrading to HomeKeeper version 2.11, you must also upgrade HUD Connect to version 1.10.
1. Presubmission Log Reports have been added, with direct links in the HUD 9902 Submission Tab, to allow users to generate and download reports with complete information on what they will be submitting to HUD. This will allow for more efficient record keeping and trouble shooting.

Clicking the link shown above will take you to a version of the packaged HUD FY 9902 Control Report, with filters specific to this reporting period, as shown below.

2. In order to help prevent incomplete or duplicate submissions, this version of HUD Connect disables the submission buttons until the refresh is complete.
3. We have vastly improved system feedback, updating multiple error messages to provide clearer and more direct information around what went wrong:
- Updated the existing HUD Connect login error message to be more user friendly, and it now includes a hyperlink to take users directly to their login settings to update.
- Updated error message to clearly inform users when they are selecting a year value that does not match their agency settings year value.
- Updated error message to clearly inform users when they are submitting data to a pilot org.


4. We've added a new field called Status Description to clarify what a submissions current status means. This field is visible in the Submission Log, and on each specific Submission record.


HUD Connect 1.9.1 (patch update, Winter 2022)
This version of HUD Connect corrected the real ("Production") URL address to communicate with HUD's Housing Counseling System website (HCS). Prior development had tested this, but it was found that testing was not successful since HomeKeeper is not a HUD agency with a real HCS login to HUD's Production server.
After packaging 1.9.1, a "push" upgrade of version 1.9.1 was provided to all users of HUD Connect who had already had version 1.9 installed as part of the HUD FY22 updates.
Version 1.9.1 will be installed going forward.
HUD Connect 1.9 (Winter 2022)
This version is fully compatible with HUD FY22 updates to the 9902 for submissions to ARM 6 in HUD HCS.
See HUD HCS website announcement and resources. As of November 2021, that includes this link: https://files.hudexchange.info/resources/documents/ARM-v6-Interface-Control-Document-February-2021.pdf
- On all HUD Submission tabs (for each submission type), the search results list were updated to reference the new fields (for FY22+) tracking HUD Required Fields Complete? and HUD Corrections Needed
- For improved user experience and training:
- Improved error text if HUD Agency Setting is missing accurate "Production" HCS login information
- Improved instructional markup for readability
- Added link in instructions to Agency and Agency Contacts (in Lightning) on respective HUD submission tabs, for ease of updates by user as needed
- Removed the "flashing red text" that showed in only certain browsers while HUD data was refreshing. This was replaced by "Please Wait" functionality, described in release notes for HUD Connect 1.8.
- Improved error text received if HUD Unique Agency ID is not completed on Agency record
HUD Connect 1.8 and prior
Older HUD Connect release notes are still housed on the original HUD Connect Release Notes support article. We are moving those notes over, while prioritizing the newer notes in a more user friendly format.
Reference: Which version of HomeKeeper was each HUD Connect version built on?
The below chart lists which HomeKeeper packaged version the depend HUD Connect packaged version was built on. This is for compatibility reference by HomeKeeper staff, developers, and other interested parties.
Version of HUD Connect | Version of HomeKeeper |
1.12 | 1.14 |
1.11 | 2.13 |
1.10.1 | 2.10 |
1.10 | 2.10 |
1.9.1 | 2.7 & 2.6 (HUD Connect 1.9 betas 1 & 2) |
1.9 | 2.7 & 2.6 (HUD Connect 1.9 betas 1 & 2) |
1.8 | 2.5 |
1.7 | 2.4 |
1.6 | 2.3 |
1.5 | 2.3 |
1.4 | 2.3 |
1.3 | 2.3 |
1.2 | 2.3 |
1.1 | 2.0 |