Introduction to INVENTORY


This article summarizes the function and configuration of the INVENTORY tool for detailed tracking of Sites, Buildings, Units, and Beds.

Refer to our INVENTORY Toolkit for information and materials to help your community successfully adopt INVENTORY.


Clarity Human Services offers two methods for communities to collect information about their “housing inventory,” i.e., the beds and units in their system:

  • In a general manner at the program level, through the Bed and Unit Inventory section of the Program Resources sidebar for the program.

  • In a more detailed and dynamic method through a module we call INVENTORY that is configured through MANAGE > SITES > Housing Inventory.

The table below describes the capabilities of each option. Both methods comply with HUD Data Standards and federal reporting guidelines.


Tracking inventory
at the program level

Tracking inventory


General count of beds or units per program.

Detailed tracking of Sites, Buildings, Units, and Beds.


General information can be provided.

Unit/Bed availability is updated in real time and is represented visually in a filterable dashboard


Can send referrals to a program.

Clients can be connected directly to a specific Unit/Bed without a referral.
Referrals to a specific Unit/Bed can be made through the Community Queue or through an INVENTORY-specific tool called the Unit Queue.


Can be set up at the program or funding source level.

Can be set up at the program or funding source level; can also be set up at the Site, Building, Unit, UCT, and Bed levels. Eligibility inherits down to the levels below it.

You are not required to select one method to use for all of your housing programs; you may choose a program-by-program approach. Refer to our INVENTORY Setup Best Practices article for more information.

For programs that will not use INVENTORY, refer to our How to Set Up a Program: Detailed Instructions article for details on configuring Bed & Unit Information.

For programs that will use INVENTORY, follow the steps described below.

Configuring INVENTORY


The first step in the configuration process is to compile a list of the entities that must be configured at each level of INVENTORY: Sites, Buildings, Unit Configuration Types, Units, and Beds.

  • A Site is a location consisting of one or more of an agency’s Buildings.
  • A Building is a physical structure containing Units.
  • A Unit Configuration Type (UCT) is a template that describes the physical attributes of a Unit – for example, a two-bedroom Unit for families or a one-bedroom Unit for single adults.
    • You may also configure Beds for the UCTs if you want to be able to refer clients to a specific Bed within a Unit instead of referring them to a Unit as a whole.

The Unit Configuration Type is where HUD bed information, such as household type and dedicated beds, is captured.

  • A Unit is the actual living space for a client/household.

Note: The exception to the Site/Building/UCT/Unit hierarchy is a Site containing only one Unit (a “Standalone” Unit), in which case no Buildings will be configured in INVENTORY for the Site.


The next step is determining which eligibility criteria you would like to tie to each Site, Building, Unit Configuration Type, Unit, and Bed (if applicable). As mentioned above, eligibility criteria can be added to INVENTORY as follows:

  • Attached directly to Site, Building, UCT, Unit, and Bed levels 
  • Inherited through programs and/or funding sources that are assigned to a Site/Building/UCT/Unit

Eligibility that is set at one level will inherit down to all the levels beneath it. 

Note: The Eligibility toggle for a Site, Building, UCT, Unit, or Bed will automatically turn on and become grayed out and read-only in these cases:

  • The Eligibility toggle is turned on for the level above.
  • A program with eligibility (or a program with a funding source that has eligibility) is assigned or inherited to that level.

Each Site, Building, UCT, and Unit can have as many funding sources as needed but can only have one program. The ability to add a new program isn’t available to the lower levels after a program is added to a level above it. 

Additional resources:


Lastly, compile a list of any specific features that you would like your users to be able to consider when searching INVENTORY. For example, do some Buildings allow pets? Do some Units have washers and dryers? You can create Custom Housing Fields to capture this information so that users can filter the dashboard for the desired features.

Next Steps

Once you have outlined these items, you are ready to configure the various elements of INVENTORY:

Note: INVENTORY Sites and Buildings cannot be deleted once a Unit is created within them. Refer to the Site, Building, UCT,  or Unit articles for details.


To ensure that INVENTORY functions as needed for your community, turn on the settings described below.

System-Level Setting

INVENTORY’s Bed & Unit Management functionality enables the Unit Queue and provides the ability to refer clients to a specific Unit/Bed from the Community Queue. Enabling Bed & Unit Management for a program disables the ability to post openings for that program under LIMITED AVAILABILITY on the Availability tab.

Use the Bed & Unit Management picklist under Referral Settings to designate whether the system’s Bed & Unit Management functionality will be applied to all programs (“Required”), or no programs (“Disabled”), or can be turned ON or OFF for each program as appropriate (“Optional”). Refer to our “Referral Settings: Overview” article for more information.

Program-Level Settings

These settings are available for each program under MANAGE > PROGRAMS. Refer to our How to Set Up a Program: Detailed Instructions article for more information.

  • Bed & Unit Management toggle
    • For programs in a Referral Setting where the Bed & Unit Management picklist is set to “Optional,” turn ON the toggle to enable the ability to refer clients to a specific Unit/Bed from the Unit Queue and the Community Queue.
      • Turning on the toggle disables the ability to post program openings under LIMITED AVAILABILITY on the Availability tab.

  • Use Inventory Calculated Records toggle
    • Turn ON the toggle for each program that should use INVENTORY information for reporting.
      • If the toggle is OFF, reports will pull the Bed & Unit Information from the program level, even if you’re using INVENTORY.
  • Manage Units/Beds toggle
    • Turn ON to enable the Units/Beds tab within the client’s program enrollment. 

  • Direct Unit/Bed Referrals picklist
    • Designate whether users will be able to select a Unit/Bed when making a referral via the client-level REFERRALS tab and the PROGRAM ELIGIBILITY DETERMINATION page:
      • Disabled: Users will not be able to refer to a Unit/Bed while making a referral to the program.
      • Optional: Users can select a Unit/Bed when referring to a program, but they are not required to.
      • Required: Users making a referral to the program must select a Unit (and Bed, if applicable)

Staff Access

Once INVENTORY has been configured, communities need to consider which access role permissions are appropriate for the various roles performed by their staff members.


Once INVENTORY has been configured, staff members with the appropriate permissions will be able to view Unit details on the INVENTORY dashboard and will have the following options for assigning clients to Units:

  • Direct Connection (no referral):
    • Connect a client directly to a Unit/Bed through the Units/Beds tab within a program enrollment.
    • Refer to our “Units/Beds Tab” article for details.
  • Referral through Community Queue:
    • Search for Units for which a particular client is eligible.
    • Refer the client to the Unit/Bed.
    • The client will automatically be assigned to the Unit/Bed through the enrollment.
    • Refer to our “Community Queue for End Users” article for details.
  • Referral through the Unit Queue:
    • Search for clients who are eligible for a particular Unit.
    • Refer the client to the Unit/Bed.
    • The client will automatically be assigned to the Unit/Bed through the enrollment.
    • Refer to our “Unit Queue” article for details.
  • Referral to a program that has Units/Beds set up:

Updated: 11/20/2023