Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Contact Support
  • Home
  • User Guide and Tutorials
  • Application Tracking

Manually Entering An Applicant

Written by Kathrina St. Flavin

Updated at May 14th, 2025

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Getting Started with HomeKeeper
  • User Guide and Tutorials
    Application Tracking Homebuyer Management Post-Purchase Monitoring and Stewardship Counseling and Education Property Development and Tracking
  • Training and Events
  • Admin Manual
    Release Notes Administrative Tasks to Maintain Your HomeKeeper
  • Featured Articles
+More

Table of Contents

Step One: Create the Service File Step-by-Step Instructions for Creating a New Service File Step Two: Enter Household Details Using the Applicant Info Tab Step-By-Step Instructions for Entering Household Details in the Applicant Info Tab Step Three: Connect the AMI Record to Calculate “Percent of AMI” Step-By-Step Instructions for Connecting the AMI Record Step Four: Enter Remaining Applicant Details Step Five: Leverage the Application Pipeline Section to track Progress

This article walks users through manually entering an applicant (or program participant) in HomeKeeper. The process may differ if your organization utilizes online applications to create files. 


Step One: Create the Service File 

Use the “New” button under Services to create a new file, selecting the appropriate Record Type, and entering key details.

Your browser does not support HTML5 video.

Step-by-Step Instructions for Creating a New Service File

Create the new Service File by clicking the "New" button on the Services tab.

Select the "New" button and create a new Service File.

Select the appropriate Service File Record Type. Your organization may be using any combination of the "out of the box" Record Types shown below, or have custom Record Types.

  • Homeownership: Includes purchase and subsequent sale transaction
  • 1-1 Counseling: For clients receiving individual counseling services
  • Assistance: Other services or financial assistance
  • Group Education Only: For clients attending educational sessions, but not receiving any other services

If you're unsure which record type to use, check with your Administrator, or refer to your Getting Started Meeting for configuration details.

An example of the New Service File record. See above for a list of record types and descriptions.

Follow your organization's naming convention for Service Files and add the appropriate "Program" and "Status." Then click Save.  

 
 

 

Step Two: Enter Household Details Using the Applicant Info Tab

Click into the Applicant Info tab in the newly created Service File to add the household's Contacts, Demographics, Household Members, Income, Assets, and Debts

Your browser does not support HTML5 video.

Step-By-Step Instructions for Entering Household Details in the Applicant Info Tab

Click into the Applicant Info tab in the newly created Service File to add the household's Contacts, Demographics, Household Members, Income, Assets, and Debts. 

On the Service File, choose the "Applicant Info" tab.

 

Enter the Primary Applicant information. 

Add information about the primary applicant. Some organizations create contact records for everyone who applies to the program, attends workshops/events, or engages in any way. If this is the case, then double-check to avoid duplicates when you enter the applicant manually. To double-check whether an applicant has a Contact record,  select “Yes” to the question “Has a Contact record for the Primary Applicant already been created?”. Then, search for the person's name and link the correct Contact. If the person does not have a Contact Record, select “No” and add their contact and household member information. 

Avoid duplicates for the primary applicant, search to see if a contact record already exists.

When using the “Applicant Info” tab, click through each application step with the prompting buttons at the top and bottom of the page.

Navigation buttons are located at the top and bottom of the Applicant Info tab.

Enter the Co-Applicant information.

Follow the process used to enter the Primary Applicant for any Co-Applicants.

For the question "Is there a Co-Applicant for this Service File?" if there is a co-applicant, select "Yes" and add information. If there is no co-applicant, then choose "No" and continue to the next section.
If there is a co-applicant, follow the same process as the primary applicant. Complete the contact and household information sections.

Add additional Household Members. 

HomeKeeper allows you to save anonymous dependents. You can leave a household member entry blank and save. The blank entry will be counted towards the household size. 

If your organization tracks information about dependents and household members (ex. schools, ages) then complete any fields that support your data goals. 

To add additional household members, on the Household Members record page, click "Add Household Member".
As long as the "Application Role" field is complete, HomeKeeper will save an anonymous household entry.

Add Income Sources. 

You can add income information that is self-reported or verified (paystubs, W2s, bank statement, etc.) You can add information about: 

  • type of income
  • gross annual amount
  • employment information
  • your organization's eligibility adjustments 
  • notes your program's income calculation

To exclude an income source from eligibility calculations on the Service File, check the box “Do Not Include In Eligibility Income”. 

Enter Debts. 

You can add information about your client's debt, including the:

  • Payee (creditor)
  • Current balance
  • Type of debt
  • Date of the verification document (or self-reported date)
  • Minimum monthly payment 
  • Verification type

Ensure that you link the debt to the correct household member's Contact record. 

Enter Assets.

Capture the applicant's assets by recording: 

  • Asset Name (use the naming convention that your organization prefers. The image example uses the bank name and the last four digits of the account). 
  • Type 
  • Value 
  • Date of the verification document (or self-reported date)
  • Verification type

Be sure to assign an asset owner and link the asset to the correct household member's Contact record. 

Complete the Applicant Info tab by selecting “Finish”. 

 
 

 

Step Three: Connect the AMI Record to Calculate “Percent of AMI” 

AMI records can be created from the AMI tab on the main navigation menu, or from the Service File “AMI” field. Use the Median Income to create an AMI. Once created and connected to the Service File, HomeKeeper will calculate the household's percent of AMI based on the household size and income. 

Your browser does not support HTML5 video.

Step-By-Step Instructions for Connecting the AMI Record 

To calculate Percent of AMI, add the appropriate AMI record under the AMI field on the Service File. This should correspond to the Year and County in which you are verifying income for this applicant. 

Identify the “AMI” field on the Service File and click the edit button. 

The snapshot shows the AMI field on the Qualifying Information which is located on the Service File.

In the AMI searchbar, click “New AMI”. 

Complete the new AMI record. You will add one median income record for each county your program serves every year.  To do that, create one AMI record for a family of 4 at 100% AMI. You do not need to add AMI records for each household size.  Once you enter an AMI record for a family of four, HomeKeeper will do the math and calculate AMI for different household sizes and incomes. 

Refresh the browser. Then, view the updated Qualifying Calculations on the right-hand panel of the Service File. 

Once you have added the Income, Household Members, and AMI record to the Service File, refresh your browser to view automated calculations under the "Qualifying Calculations" section.

 
 

 

Step Four: Enter Remaining Applicant Details 

Enter any additional details collected in your application on the Service File "Details" tab, under the About the Applicant, Living Situation at the Time of Application, and Application Details sections. 

Your browser does not support HTML5 video.

Information like First Time Homebuyer Status, Primary Language Spoken, Veteran Status, etc. can be entered under About the Applicant on the Service File Details tab. 

About the Applicant section of the Service File. Here, you can find additional information about the applicant, like referral source, veteran status, or primary language spoken.

Sections like Living Situation at Time of Application and Application Details allow your program to capture additional details about applicants. Living Situation at Time of Application can help your organization capture the impact of homeownership on the client's financial and personal living situation. 

On the Service File, Living Situation at Time of Application and Application details allow programs to capture more information about the applicant.

Step Five: Leverage the Application Pipeline Section to track Progress

The Application Pipeline section of the Service File is there to help you track where applicants are at in the process of applying and qualifying for your programs.

Your browser does not support HTML5 video.

As applicants complete steps, check them off in this section to see at a glance what steps still need to be completed in order to move the application forward. Standardizing this section also allows you to create reports and List Views that show you a bird's-eye view of your entire application pipeline.

An example of the "Application Workflow" section of the Service File. Here the program can track the client's progresses through the program as they submit documents and complete required steps.
entering applicant entering client

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • Winter 2025 (Version 2.14) Release Notes
  • Troubleshooting Errors when Submitting to HUD

Copyright 2025 – groundedsolutions.

Knowledge Base Software powered by Helpjuice

Expand