Unit Queue for End Users



This article explains how to use INVENTORY’s Unit Queue to refer clients to a specific Unit based on Unit Eligibility criteria and Unit availability. For information on configuring the permissions and settings associated with this function, refer to Unit Queue.

When you click on a Unit, the system will analyze the Unit’s Eligibility criteria, assess those criteria against the clients who are currently on the Community Queue, and display all clients who are eligible for that Unit. You can then click a REFER button next to a client name to initiate referring that client to the Unit.

Accessing the Unit Queue

To navigate to the Unit Queue, click on SEARCH > REFERRALS in the upper right corner of the screen; the Unit Queue tab will be visible. 

Click on the Unit Queue tab to display available Units. 

  • Units that are currently Offline or Inactive will not be listed on the Unit Queue.
  • Units with future-dated Offline or Inactive dates will be available for referral from the Unit Queue and can be connected to a referral for an occupancy that is outside of the actual Offline/Inactive Dates.
  • The Units that are displayed will depend on the system’s Coordinated Entry Type: 
    • If the Coordinated Entry Type is “Continuum of Care Based,” the Unit Queue shows all Units within the CoC of the agency that owns the program assigned to the Unit.
    • If the Coordinated Entry Type is “Sharing Groups Based,” the Unit Queue shows all Units within the Sharing Group of the agency that owns the program assigned to the Unit. If the agency has more than one Sharing Group assigned, the Unit Queue shows the Units within the Primary Coordinated Entry Group.
  • Units with a “Pending Occupancy” status will not be available in the Unit Queue.
  • Units associated with a program with a Project Status of “Active, Expired” (based on the program assigned to the Unit’s current Unit Configuration Type) will not be available on the Unit Queue.

The Units will be listed alphabetically. A line below the Unit name lists the Agency, Program, Site, and Building associated with that Unit.

Filtering the Unit Queue

If desired, use the filters to search for specific types of Units: 

  • Agency: This allows you to limit your search results to Units associated with the agency of the program connected to the Unit. If you select an agency, the options available in the Program Funding drop-down will be limited to funding sources related to the selected agency.
  • Program: This allows you to limit the search results to Units associated with a specific program. If you select a program, the options available in the Program Funding drop-down will be limited to funding sources that are connected to that program. 
  • Program Funding: This allows you to limit the search results according to the funding source(s) connected to the program. Inherited funding sources are included in the drop-down list.
  • Include Units with Pending Referrals:
    • Toggle ON if you want to include Units with pending referrals in your search results.
    • Toggle OFF if you do not want to include Units with pending Referrals in your search results. “Off” is the default value.

Select the appropriate parameters, then click SEARCH. 

Viewing Unit/Bed Details

Click the down arrow for a Unit to display information about that Unit.

If Beds are enabled for the Unit, you will see a list of Beds when you click the down arrow for the Unit. Click the down arrow for a Bed to display information about that Bed.

View additional details for the Unit/Bed (available according to the user’s access role) by clicking on the Current Unit Configuration name, Site Name, Building Name, Unit Name, or Connected Program name.

Checking Eligibility for a Unit/Bed

To check eligibility for a selected Unit/Bed, choose one of the following:

  • Recommended Usage: Click the ELIGIBILITY button if you want the system to analyze the Unit’s eligibility criteria, assess those criteria against the potential client pool (which consists of clients who are already on the Community Queue), and display all clients eligible for that Unit. 
    • If no eligibility criteria are configured, all clients on the Community Queue will be displayed.
  • Click Eligibility Override in the lower right corner if you want the system to display all clients/referrals that are currently on the Community Queue, regardless of eligibility criteria.


  • This Eligibility Override function is only available to users with the Referrals - Unit Eligibility Override Access Right enabled. 
  • If Prohibit Eligibility Override is in effect for the Unit, the Eligibility Override link will not be visible.
  • If Include Units with Pending Referrals (described above) is enabled, the ELIGIBILITY and Eligibility Override buttons will not be displayed for Units/Beds with a Pending Occupancy.

Based on your selection, the system looks for clients who can be referred to this Unit. The clients will be grouped according to Community Queue first and then by referral assessment. The Unit Queue pulls from the clients assigned to the Community Queues.

  • This list will only show Community Queues connected to programs associated with the Unit.
  • If the Unit’s program does not have any assigned Community Queues, the Unit will not appear on the Unit Queue at all. 

Note: When a direct referral is made, denied, and sent back to the queue, the client will appear on the list under the heading of “None” to indicate that the client is on the queue without an assessment.

BUI 542 b

As shown below, click on the arrow next to a Community Queue (a) to display the referral assessments (b) associated with the clients. Click on the arrow next to an assessment to display the client names (c). By default, the client list is in alphabetical order. Click the column header to sort by the column (Client, Referral Date, Days Pending, Score).

BUI 542 annotated

Click the REFER button next to a client’s name to begin the referral process for that client. This process is similar to referring a client from the Community Queue to a program.

To prevent accidental referrals to a Unit, you will see the following alert: “Please confirm you would like to refer [Client - First Name, Last Name] to [Unit name].”

Note: Referrals from the Unit Queue will count as inferred Coordinated Entry Events where applicable, following the same logic as referrals from the Community Queue.

When a client is referred to a Unit from a listed Community Queue, the client will then be removed from the Community Queue tab and will be visible under the Pending tab. 

When the referral is connected to the Unit, the Unit’s status changes to “Pending Occupancy.”

The system assumes that the Unit is “Pending Occupancy” on the date when the Unit referral is sent.

If the Site/Building/Unit Configuration Type/Unit belongs to one agency, and the program connected to it belongs to another agency, the referral will go to the Program agency.

You will then be able to view the new referral under the Pending tab. Click on the Edit icon next to the referral to see the REFERRAL: EDIT page.

Scroll down to see the referral listed in the HISTORY section.

Hovering over a referral event will display a tooltip that identifies the item.

Note: You may also connect referrals to Units via the Community Queue. Refer to our Community Queue for End Users article for details.

Adding a Referral Connection

If the client already has client Program records for the referred program, scroll to the REFERRAL CONNECTIONS section and click ADD CONNECTION

The ADD A NEW CONNECTION pop-up displays a list of Program records with a start date on or before the current date. Select the appropriate program to create the connection.

If the client doesn’t have any client Program records for the referred program, the ADD CONNECTION link will not be displayed.

Enrolling the Client

When you enroll the client in the referred program, the Unit’s status on the UNITS page changes to “Occupied.”

When connecting a Unit referral to a program, the Unit Start Date will be the date that the referral was connected to the program. If the Unit tab is visible within the program enrollment (managed within the program setup), the Unit Start Date can be adjusted manually. If the Unit is still open when the client exits from the program, the Unit End Date will update to the Program Exit Date.

Click the down arrow next to that Unit to view details about the occupant(s).

In the Inventory module, the green “Available” icon for that Unit (on both the list on the left side of the page and the pop-up Unit Card) will change to the yellow “Occupied” icon.  

If the Unit is “Pending Occupied” or “Occupied,” the system prevents you from making certain changes related to that Unit setup:

  • You will not be able to change the Unit’s status from “Active” to “Inactive” or “Offline.” The Status field on the MODIFY UNIT page will be greyed out. If you hover over the Status field, you will see a tooltip explaining that the Unit Status cannot be updated.

  • You will not be allowed to delete the program from this Unit or from the level from where the program was inherited to the Unit.

Updated: 5/25/2023