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.

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.

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:

Selected Filters will display in the Search bar.

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.

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.

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.

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.

At the top of the referral screen, the type of referral, status of the referral, and any additional details display in the 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.

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.

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.

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:
- Referral Connections (click link for more information)
- View Audit Log (requires System Administrator access)
- Delete (may require additional access rights)

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.

Icons & Tooltips
|
Icon |
Icon/Tooltip Name |
Tooltip |
Icon Location |
|
|
Action Menu, also known as:
|
"Show more actions" |
All workspaces: typically on the far right of a workspace or section |
|
|
Add |
“Add” |
All workspaces: anywhere the “Add” option occurs |
|
|
Arrows/Dropdown | (no tooltip) | All workspaces: Anywhere you see this icon, you can click to collapse or expand the section |
|
|
Check-In | (no tooltip) | Referral record: Information box |
|
|
Column Selector |
"Show/hide fields" |
All workspaces: typically paired with a search bar |
|
|
Completed Status |
(no tooltip) |
Referral Status column; Referral record: Information box |
|
|
Date |
(no tooltip) |
Anywhere a Date appears |
|
|
Delete |
“Delete” |
All workspaces: anywhere the “Delete” option occurs |
|
|
Denied Status |
(no tooltip) |
Referral Status column; Referral record: Information box |
|
|
Edit |
“Edit” |
All workspaces: anywhere the “Edit” option occurs |
|
|
Expired Status |
(no tooltip) |
Referral Status column; Referral record: Information box |
|
|
Filter |
"Add a filter" |
All workspaces: typically paired with a search bar |
|
|
Incoming Referrals |
(no tooltip) |
Referrals navigation menu: Incoming Referrals |
|
Note | “Note [formatted note text]” | Referrals list |
|
|
Pending Status | (no tooltip) | Referral Status column; Referral record: Information box |
|
|
Pending - In Process Status | (no tooltip) | Referral Status column; Referral record: Information box |
|
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 |
Varies depending on workspace; example from client profile: “Public Client data is shared.” |
Referral record; All workspaces within the client record |
|
|
Referral Alert | (no tooltip) | Referral record: Information box |
|
Referral Connections | (no tooltip) | Action Menu option on Edit referral details page |
|
|
Search |
"Search" |
All workspaces:
|
|
|
Sort |
"Configure sorting" |
All workspaces; typically to the right of a Search bar |
|
|
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:
- Introduction to Making Referrals (New Clarity Interface)
- Referral Connections (New Clarity Interface)
- Referral Details Glossary (New Clarity Interface)
- Referral History (New Clarity Interface)
- Referral Status Updates (New Clarity Interface)
Updated: 11/20/2026