Skip to content
  • There are no suggestions because the search field is empty.

Global Referrals: Incoming Referrals

Learn how to view, search, and manage your agency's incoming referrals, including pending, completed, denied, and expired referrals.

Table of Contents

Video Resources

Click play for a brief overview:

Overview

The Incoming Referrals workspace is available in the global Referrals module. It includes all incoming referrals for an agency, including those referrals with a Pending, Pending - in Process, Completed, Denied, or Expired status.

The workspace shows referrals made directly or reassigned to programs at the agency you are viewing data for, from users in your agency and in other agencies.

The Incoming Referrals workspace with no clients showing

Notes:

  • A user’s access to the Incoming Referrals workspace is configured in access roles. See Rights Glossary for Access Roles or Coordinated Entry Roles for more information about the different access settings. 
  • A referral created with a future Referral Date will not appear on the Incoming Referrals workspace until that future date.
  • If you used Referrals in the legacy interface, the Incoming Referrals workspace replaces the Pending, Completed, and Denied tabs. This workspace opens with a filter for Pending and Pending - In Process referrals. Use the Referral Status filter to see completed, denied, or expired referrals.

Options to Refine Search Results

The Incoming Referrals workspace includes multiple options to refine and view search results:

Search Bar

The Incoming Referrals workspace includes a Search bar.

The Search bar on the Incoming Referrals workspace

Users can search by:

  • Client name
  • Program name

Filters

Users can add a filter by clicking on the filter icon.
  • Users can filter by:
    • Referral Status 
    • Program
    • Referred by Agency
    • Project Type
    • Eligible Clients
    • Tracked Characteristic 
    • Assessment Name
    • Assessment Processor
    • Score range
    • Referral Date Range

Note: Clicking on one of the above filters will display any additional options to choose from for the filter. Users can select additional options, then click Apply to use as a filter. Please see an example for the Program filter:

Incoming Referrals.Filter Selection.1

Selected Filters will display in the Search bar.

Incoming Referrals search bar showing filters selected

By default, the page loads the Incoming Referrals workspace with a filter for referrals with a Pending or a Pending - in Process status. The workspace can be filtered to show referrals with Completed, Denied, or Expired status.

Tracked Characteristics filter: Users can select multiple Tracked Characteristics. When multiple characteristics are selected, the system uses OR logic and returns referrals that match at least one of the selected characteristics.

This differs from the legacy interface, where only one Tracked Characteristic can be selected at a time.

To filter for referrals that must meet more than one condition together (AND logic), a System Admin must configure a single Tracked Characteristic with multiple conditions joined by "And" in Referral Settings. See the Multiple Conditions section in the Referral Settings: Tracked Characteristics article for instructions.

Refer to the Client Record Overview article for more information about filters.

Sorting Options

The Incoming Referrals table includes multi-layer sorting. 

Users can sort by:

  • Referral Status
  • Program
  • Referred by Agency
  • Project Type
  • Eligible Clients
  • Tracked Characteristics
  • Referral Date
  • Case Manager
  • User Creating
  • Assessment Name
  • Assessment Processor
  • Score Range
  • Assessment Score
  • Days Pending
  • Days In Process
  • Last Activity

Users can utilize the checkboxes to add or remove sort options and the arrows to set the sort direction. Use the drag and drop method to move the sort options up or down or use Clear All to remove all sort options.

CE.CQ Tab.10

Column Selector

The Incoming Referrals workspace includes a column selector. 

The Incoming Referrals column shows the following by default:

  • Client
    • Client's Name
    • Referred by: Agency
  • Program
    • Name of Program
    • Program's Agency
  • User Creating
    • User Home Agency
  • Tracked Characteristics
  • Status
  • Referral Date
  • Days Pending

The following are also available:

  • Case Manager
  • Days In Process
  • Last Activity
  • Qualified
  • Assessment Name
  • Assessment Processor
  • Score Range
  • Assessment Score
  • Latest Note

The table is responsive to the user’s screen size. Columns shift between visible and collapsed as the screen size changes.

Global Referrals.8

The selections made in the column selector are saved in the user’s browser and determine what they see the next time they view that screen. Refer to the Client Record Overview article for more details.

Referral Status

A referral's status shows where it is in the referral process. The statuses are:

  • Pending: The referral has been sent to a program. Clarity assigns this status automatically on the Referral Date. A user can also assign it manually.
  • Pending - In Process: The client has not yet enrolled in a program, but the referral is actively being processed. Users assign this status manually.
  • Completed: The referral resulted in a program enrollment. This happens when the client is enrolled in the program the referral was sent to and the user indicates the enrollment is the result of a referral, or when the client is enrolled in another program and the enrollment is recorded as a Referral Connection. A user can also set the status to Completed manually.
  • Denied: A user manually updated the status of a referral sent directly or reassigned to a program to Denied.
  • Expired: A referral changes to Expired automatically when a Community Queue referral reaches the Inactive Referral Expiration Threshold, or when a Pending or Pending - In Process referral reaches the Community Referral Threshold. A user can also set the status to Expired manually, for example, to correct a data entry error that caused the referral to miss a threshold.

For how to change a referral's status, refer to Referral Status Updates.

The Incoming Referrals workspace has a summary of the user's agencies' referrals, organized by status. There is a Referral Status chart in the sidebar.

  • The chart has a date range picker for the user to select a timeframe.
    • By default the date range is set to the Last 30 days, based on the current date.

  • The chart displays by default, but can be collapsed when the user clicks the information icon in the secondary title bar.

Global Referrals.9

Community Referral Threshold

When a referral to a Community Queue is reassigned to a program, it will appear in the Incoming Referrals workspace on its Reassignment Date and will be assigned a Pending status.

How long it stays in the Incoming Referrals workspace depends on the queue’s Community Referral Threshold setting, which is set by system administrators in Referral Settings. Once the referral threshold period has passed, the referral status will change to Expired, and the referral will display with a Denied status. The system will generate a new referral with the information associated with the original referral, but with a different referral ID.

A referral to a Community Queue also changes to Expired when it reaches the queue's Inactive Referral Expiration Threshold, which system administrators also set in Referral Settings.

Referral Record

Users with the appropriate access can edit or view a referral record from the Incoming Referrals workspace.

When the user clicks on a client referral record from Incoming Referrals workspace, it opens the associated screen of the referral. The information displayed and/or editable is based on sharing and access role permissions, as well as the referral status.

Incoming Referrals_Edit referral

At the top of the referral screen, the type of referral, status of the referral, and any additional details display in the information box.

Information Box

For referrals where the “Check-In” button applies, it will be located in the information box. When a user clicks the check-in button, the Last Activity Date will update to the date of the check-in.

Referral Information Box_Check In

When a referral is opened from the global Referrals module, a "View Client" button to navigate to the client record is also in the header.

Information Box_View Client

The sections of the referral are:

  • Referral
  • Notes
  • History

View and Edit Referrals 

The Referral section is where the end user can, with the appropriate access, edit the referral, manage the privacy of the referral, make Referral Connections, delete the referral, and/or access the audit log for the referral. 

Referral Page

The Edit referral details section includes (depending on referral type and status):

  • Referred Program
  • Referred to Agency
  • Referring Agency
  • Referred Unit
  • Referred Date
  • Days Pending
  • In Process
  • Qualified
  • [Assessment Processor Name] Score
  • Referred by Staff
  • Case Manager
  • Last Activity
  • Current Status
  • If Denied:
    • Denied By Type
    • Denied Date
    • Denied by
    • Denied Reason
    • Denial Information
    • Send to Community Queue
  • Hide from customer portal toggle

Notes Section

The Notes section of any referral includes a list of notes and the ability to add notes. 

History Section

The History section of any referral includes a complete history of all actions taken for the referral.

Additional Actions

An action menu for incoming referrals includes:

Delete a referral only if you created it in error. To restore a deleted referral, refer to Restoring Deleted Data.

Audit Log

System Administrators with the Audit Log access right can view audit logs throughout the system. Refer to Rights Glossary for Access Roles for details on access rights.

To open the audit log, click the Action Menu (three dots) icon for the referral and select View Audit Log. The audit log shows all changes made to the referral.

Client Referrals_Audit Log

Icons & Tooltips

Icon

Icon/Tooltip Name

Tooltip

Icon Location

Action Menu icon.Nov25

 

Action Menu, also known as:

  • 3 dots
  • vertical ellipsis
  • kebab

"Show more actions"

 All workspaces: typically on the far right of a workspace or section

Add Icon.Aug25

 

Add

“Add”

 All workspaces: anywhere the “Add” option occurs

Arrows Icon

 

Arrows/Dropdown (no tooltip)  All workspaces: Anywhere you see this icon, you can click to collapse or expand the section

Check-In Icon

 

Check-In (no tooltip) Referral record: Information box

Column Selector icon.Nov25

 

Column Selector

"Show/hide fields"

 All workspaces: typically paired with a search bar

Completed Referral Icon

 

Completed Status

(no tooltip)

Referral Status column; Referral record: Information box

Icons.Dec25.1

 

Date

(no tooltip)

Anywhere a Date appears

Delete Icon.Aug25

 

Delete

“Delete”

All workspaces: anywhere the “Delete” option occurs

Expired Referral Icon

 

Denied Status

(no tooltip)

Referral Status column; Referral record: Information box

Edit Icon.Aug25

 

Edit

“Edit”

All workspaces: anywhere the “Edit” option occurs

Expired Referral Icon

 

Expired Status

(no tooltip)

Referral Status column; Referral record: Information box

Filter icon.Nov25

 

Filter

"Add a filter"

All workspaces: typically paired with a search bar

Incoming Referrals Icon.Dec25.1

 

Incoming Referrals

(no tooltip)

Referrals navigation menu: Incoming Referrals

Note Icon.Aug25

 

Note “Note [formatted note text]” Referrals list

Pending Icon

 

Pending Status (no tooltip) Referral Status column; Referral record: Information box

 Pending Icon

 

Pending - In Process Status (no tooltip) Referral Status column; Referral record: Information box
Privacy Icon.Private.Nov25

 

Privacy - Private

Varies depending on workspace; example from client profile: “Private Client data is not shared.”

Referral record; All workspaces within the client record

Privacy.Public Icon.Aug25

 

Privacy - Public

Varies depending on workspace; example from client profile: “Public  Client data is shared.”

Referral record; All workspaces within the client record

Referral Alert Icon

 

Referral Alert (no tooltip) Referral record: Information box
Referral Connection icon

 

Referral Connections (no tooltip) Action Menu option on Edit referral details page

Search icon.Nov25

 

Search

"Search"

All workspaces: 
  • typically paired with a search bar
  • also available in the top right corner at all times for client searches

Sort Icon

 

  Sort

"Configure sorting"

 All workspaces; typically to the right of a Search bar

View Audit Log Icon

 

View Audit Log

(no tooltip)

Any workspace where audit log functionality is available; visibility is dependent on access rights

Additional Resources

This article provides an overview of the global Referrals module, which includes links to all possible global Referral workspaces:

The following articles provide general referral information:


Updated: 11/20/2026