---
title: "Securing a legal hold project"
description: "Configure permissions for each user group that needs access to legal hold projects."
feature: "Legal Hold"
audience: ["end user", "developer", "system analyst", "system administrator", "system engineer"]
version: "Relativity aiR"
type: ["User Guide", "Tutorial"]
url: "https://help.relativity.com/RelativityaiR/Content/Relativity_Legal_Hold/Workspace_security.htm"
lastModified: "2026-11-20"
---

# Securing a legal hold project

To run a legal hold project, configure permissions for each user group that needs access. The following sections cover feature permissions, project-level application permissions, and instance-level permissions.

## Feature permissions

You must set certain permissions for a Legal Hold user to run and complete a project. Use the following feature permissions to configure access by group.

Feature Permissions provide an alternative to Relativity's security management by shifting the focus from Object Types and Tab Visibility to feature-based permissions. Any feature-specific permissions information already in this and other topics is still applicable. The Feature Permissions interface enables administrators to manage permissions at the feature level. By viewing the granular permissions for each feature, you can reduce configuration errors.

For details, see [Instance-level permissions](https://help.relativity.com/RelativityaiR/Content/Relativity/Security_permissions/Instance_security.md#Instance-level-permissions) and [Workspace-level permissions](https://help.relativity.com/RelativityaiR/Content/Relativity/Security_permissions/Feature_permissions.md#Workspace-level-permissions).

### Actions

With feature permissions, you can select the actions each group can take. With Legal Hold, you can select the following actions:

| Action | Description |
| --- | --- |
| **View Legal Holds** | View existing legal hold projects and their details. |
| **Approve Communications** | Approve communications before they are sent to custodians. |
| **Manage Projects** | Create, edit, and manage legal hold projects. |
| **Manage Custodians** | Add, edit, and manage custodians within a legal hold project. |
| **Manage Communications** | Send, preview, remind, and escalate communications within a legal hold project. |
| **Configure Legal Hold Settings** | Configure workspace-level Legal Hold settings. |
| **Delete Projects** | Delete legal hold projects from the workspace. |
| **Release/Remove Custodians** | Release or remove custodians from a legal hold project. |
| **Delete Communications** | Delete communications from a legal hold project. |
| **Delete Reports** | Delete reports generated within Legal Hold. |
| **Delete Legal Hold Settings** | Delete Legal Hold settings configurations. |

## Legal Hold Application Permissions

Legal Hold custom permissions are independent from the System Admin group and are not automatically assigned to it. To give a group access to Legal Hold project functions, add it to the Legal Hold Security Admins group. You can also create a new group with the required permissions.

When you install Legal Hold into a workspace, Relativity creates a Legal Hold Security Admins group. By default, this group includes only the Legal Hold custom permissions in the **Legal Hold Application Permissions** section. The Legal Hold Application Permissions section appears in the workspace permissions UI and controls which buttons and actions are available to users in Legal Hold. The following permissions are not included and must be added manually:

- Object-level permissions
- Tab visibility
- Other workspace permissions required to use Legal Hold

You can add users to this group, create new groups, or give existing groups Legal Hold permissions by selecting the custom Legal Hold permissions.

> **Note:** If a button does not appear in Legal Hold, the corresponding permission checkbox may not be selected for your group.

To set these custom permissions:

1. Navigate to the **Workspace Details** tab.
2. From the Relativity Utilities console, click **Manage Workspace Permissions**.
3. Determine the group you want to apply these custom permissions to, then click **Edit Permissions** on that group.
4. Scroll down to the **Legal Hold Application Permissions**.
5. Select the checkbox next to the permissions that you want to grant the users in the specified workspace group.  
   You also need to ensure that a corresponding object level permission is also set to Add or Edit.  
   If you leave a checkbox cleared, users in that group cannot perform the permission, which corresponds to a button or link in Legal Hold or the Custodian portal.

   <details>
   <summary>Legal Hold Application Permissions</summary>

   - **Approve Communications**—Approve button on Project console appears when:
     - **Approve Communication**—select this checkbox.
   - **Assign Custodian**—Assign button on the Project console appears when:
     - **Assign Custodian(s)**—select this checkbox.
     - **Object level permission: Custodian Role**—Add
   - **Release Custodian(s)**—Release button on the Project console appears when:
     - **Release Custodian(s)**—select this checkbox.
     - **Object level permission: Custodian Role**—Edit
   - **Remove Custodian(s)**—Remove button on the Project console appears when:
     - **Remove Custodian(s)**—select this checkbox.
   - **Open Project/Close Project**—Open and Close buttons on the Project console appear when:
     - **Open Project/Close Project**—select this checkbox.
     - **Object level permissions:**
       - **Project**—Edit
       - **Preservation Custodian Status**—Read
       - **Message**—Create
       - **Custodian Role**—Edit
   - **Send Communication(s)**—Send Communication button on the Communication console appears when:
     - **Send Communication(s)**—select this checkbox.
   - **Send Communication Preview**—Send Preview button on the Communication console appears when:
     - **Send Communication Preview**—select this checkbox.
   - **Send Communication Reminder**—Remind button on the Communication console appears when:
     - **Send Communication Reminder**—select this checkbox.
   - **Send Escalation**—Escalate button on the Communication console appears when:
     - **Send Escalation**—select this checkbox.
   - **View Portal As Custodian**—controls the ability to access the Custodian portal and view active holds, tasks requiring attention, and completed tasks.
     - **View Portal As Custodian**—select this checkbox.
   - **Act on Behalf Of Custodian**—Acknowledge on Behalf button on the Communication console. Controls the ability to acknowledge or respond on behalf of another custodian.
     - **Act on Behalf Of Custodian**—select this checkbox.
   - **Respond to Message**—Reply to Message button on the Reply console appears when:
     - **Respond to Message**—select this checkbox.
     - **Object level permission: Message**—Add and Edit
   - **Send Global Reminder Now**—Send Global Reminder Now button on the Global Reminder console appears when:
     - **Send Global Reminder Now**—select this checkbox.
   - **Send Test Global Reminder**—Send Test Email button on the Global Reminder console appears when:
     - **Send Test Global Reminder**—select this checkbox.
   - **Test Outgoing Email Settings**—Test Outgoing Email Settings button on the Settings console appears when:
     - **Test Outgoing Email Settings**—select this checkbox.
   - **Send Project Reminder Now**—Send Project Reminder button on the Project Reminder Notify console appears when:
     - **Send Project Reminder Now**—select this checkbox.
   - **Send Test Project Reminder**—Send Test Email button on the Project Reminder Notify console appears when:
     - **Send Test Project Reminder**—select this checkbox.
   - **Preservation Hold**—controls the ability to add, edit, or remove preservation holds within projects.
     - **Preservation Hold**—select this checkbox.

   System admins must ensure that the following object level permissions are enabled for specific buttons or links to appear in the Legal Hold UI.

   > **Note:** These object level permissions are not contained in the Legal Hold Application Permissions.

   - **New Project** button—you can create a project from a template when the following permissions are enabled:
     - **Project**—Add, Edit
     - **Communication**—Add, Edit
     - **Questionnaire**—Add, Edit
   - **Create Communication** button—this button appears when:
     - **Communication**—Add, Edit
     - **Questionnaire**—Add
     - **QuestionnaireQuestion**—Add, Edit
   - **Schedule Report** button—this button appears when:
     - **Scheduled Report**—Add, Edit
     - **Job Schedule**—Add
   - **Add** link—this link appears on the Communication layout Portal Content tab when:
     - **Object level permission: Field**—Add, Edit
     - **Add Field Choice By Link**—select this checkbox.

   System admins must ensure that the following permissions are enabled for specified users to run reports from the Project and Communication consoles.
   - **Tab Visibility - Legal Hold::Reports**—select this row.

   > **Note:** We recommend not overwriting inherited security on the Reports tab. This may cause unexpected report permissions issues.

   For the Question Response report link to appear on the Communication console, the following must be in place:
   - The communication contains a questionnaire.
   - The user has permission to view the Question Responses tab under the workspace tabs and under Tab Visibility.
   - **Object Security - Question Responses and Questionnaire Response Answer**—View

   For the Question Response report link to appear on the Custodian and Project Details, the following must be in place:
   - The user has permission to view the Question Responses tab under workspace tabs and under Tab Visibility.
   - **Object Security - Question Responses and Questionnaire Response Answer**—View

   </details>
6. Click **Save**.

> **Note:** The Legal Hold Application Permissions are only available when the Legal Hold application is installed.

For more information, see [Security and permissions](https://help.relativity.com/RelativityaiR/Content/Relativity/Security_permissions/Managing_security.md).

## Instance permissions for the rich text editor

To add a hyperlink when using the rich text editor, you must be in the Legal Hold admin group, or a group that has the following permissions:

- **Object Security - InstanceSettings**—View
- **Admin Operations - View Admin Repository**

For more information, see [Instance Details tab](https://help.relativity.com/RelativityaiR/Content/Relativity/Instance_details.md).

For more information on hyperlinks, see [Creating a communication](https://help.relativity.com/RelativityaiR/Content/Relativity_Legal_Hold/Creating_communications.md).
