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

Program Restrictions (New Clarity Interface)

The Program Restrictions feature provides a way for an end user to document when a client has been denied future services at one or more programs.

This article is part of the February 2026 Features Update. The functionality described in the article will be available on training sites on January 27, 2026, and on live sites on February 10, 2026.

This article is for the new Clarity interface. Screenshots and descriptions will be updated as features are released. For the current interface article, please click this link

Overview

Users can view, add, edit, or delete restrictions if their Access Rights and their agency’s Notes Sharing Settings permit. The Restrictions tab is located in the client’s navigation menu.

Program Restrictions Tab

This article includes the following sections:

Notes

  • The Reason For Program Restriction options are determined by system administrators by editing the “restriction_reason” field in the Field Editor. Please contact your system administrator if you need assistance determining which Reason For Program Restriction option to select.
  • If you leave the End Date blank, the program restriction is considered indefinite and will remain effective until an end user edits the program restriction and adds an End Date. When an end user creates a program restriction without adding an end date and clicks Save, a pop-up warning appears. This warning will appear when a program restriction is created or updated from both the client NOTES tab or a program enrollment’s Exit Screen.

    Program restriction.warning
  • Program Restrictions do not prevent a client from being enrolled in a program with a documented Program Restriction. 

Existing Program Restriction Management

Users can sort, filter, and search all restrictions for a client in the Program Restrictions tab.

Program Restrictions_Search Options

By default, the program restriction table is sorted with the most recent program restriction Start Date at the top. Users can search by:

  • Program Name
  • Reason for Program Restrictions

Users can filter by:

  • Program Name
  • Reason for Program Restriction
  • Active/Inactive

Sort options include:

  • Program Name
  • Reason for Program Restriction
  • Start Date
  • End Date

 Users can customize which columns are shown with a column selector. The following columns are displayed by default:

  • Program Name(s) - display all programs
  • Reason for Program Restriction
  • Start Date
  • End Date

Additional column options include:

  • Agency Created
  • User Created
  • User Updated
  • Notes

For more information about column selectors, please refer to the Client Record Overview article.

Editing a Program Restriction

Users with the appropriate access can edit existing restrictions by selecting a record on the Program Restrictions page, then clicking the Edit icon.

Program Restrictions_Editing

When editing a restriction, there is a lock icon in the top right corner that allows users to mark it Private. For more information about making a client record private, please refer to the Making Client Data Private article.

Users can edit any field or delete the restriction here, depending on their access rights.

Program Restrictions_Edit or Delete

Adding New Program Restrictions 

Users with the appropriate access can add new Program Restrictions from the Restrictions tab or from a program exit screen.

Adding from the Restrictions Tab

From the Program Restrictions page, users can add a new Program Restriction by clicking the Add icon.

Program Restrictions_Add Icon

Enter a Start Date (required) and an End Date (not required), select one or more Program(s) (required), select a Reason For Program Restriction (required), and type the desired text in the Note field (not required). 

Add Program Restriction_New

Program restrictions are, by default, shared based on the agency’s Notes Sharing Settings. You may also turn on the Private toggle, which means the program restriction will only be visible to staff members at your agency, regardless of the agency’s sharing settings. For more information about marking items “Private,” please refer to the Making Client Data Private article.

Program selection is limited to programs available within the user’s agency.  

If you leave the End Date blank, the program restriction is considered indefinite and will remain effective until an end user edits it and adds an End Date

When an end user creates a program restriction without adding an end date and clicks Save, a warning appears that reads:

"You are about to create a permanent program restriction for this client. Are you sure you want to proceed?"

Program Restrictions_Indefinite Restriction

The user can click Cancel and update the End Date or click Confirm & Save.

If the user does not create an indefinite restriction, they can click Cancel to return to the Program Restrictions page or Save to save the restriction.

Adding from the Program Exit Screen

Users can initiate a program restriction directly from the program exit screen and view any previous restrictions for that program.

  • There is a "Restrictions" chip-style notification in the program enrollment details section.
    • The notification is visible when there is one or more prior, future, or current restrictions for the current program.
    • When a user hovers over the chip, a tooltip displays the prior/future/current restrictions in a table format.
      • The table displays columns for the Program(s), Start date, and End date.
      • The table is sorted with the latest restriction start date at the top.
      • The user can expand each row to see the Reason and Notes.
    • When a user clicks on the Restrictions notification, the system takes the user to the Restrictions tab.
  • There is an option in the action menu of the program exit screen, "Add Program Restriction."
    • The option to add a restriction from the program exit is tied to the Create Public Alerts, Client Notes, and Program Restrictions access right.
      • If toggled ON, the user is able to create the program restriction from the program exit or the Restrictions tab.
    • Clicking Add Program Restriction opens a screen for the user to enter restriction details.
    • When initiated from the exit screen, the user can select which enrollment household members to create restrictions for.  A different restriction is created for each household member.
    • The current program is selected by default but remains editable. If the user unchecks the current program, the program restriction will still be created.
    • After the restriction is Saved or Canceled, the system takes the user back to the exit screen they were on.
  • Start Date, Program(s), and Reason are required fields when adding a restriction; End Date and Note are optional.
  • When creating or editing a restriction, there is a lock icon in the top right corner that allows users to mark it "Private."
  • Program selection is limited to programs available within the user’s agency.
  • Attempting to save a restriction without an End Date triggers a warning, clearly communicating that an indefinite restriction is being created, and requiring confirmation to proceed or an opportunity to add an End Date before saving. Warning text: “You are about to create a permanent program restriction for this client. Please OK to continue, or Cancel to add an end date.”

Audit Log

    System Administrators can access the audit log by editing the restriction, clicking the action menu icon, and selecting View Audit Log.

    Program Restrictions_Audit Log

    The audit log shows date/time, user, and action (created, edited, deleted).

    Program Restrictions_Audit Log Details

     

    Published: 01/20/2026