Last date modified: 2026-Nov-09

Permissions scenarios

In this topic, you can explore various scenarios that involve managing permissions.

See the following related pages:

Hierarchical structure

System administrators have the highest level of managerial rights followed by workspace administrators. Standard users have limited administrative capabilities and primarily operate within the permissions assigned to them.

  • System administrators—have the highest level of administrative rights with broad access to system settings, configuration, and management functions. Their permissions and rights supersede those of other user groups. They can control the overall system behavior, user management, security settings, and other administrative tasks.
  • Workspace administrators—have administrative control over specific workspaces. They can manage settings, configurations, object permissions, and layouts within their assigned workspaces, and they can be granted permission to change other groups' security in those workspaces. Creating users and groups and managing group membership happen at the instance level.
  • Standard users—do not have administrative privileges and cannot modify system or workspace settings. They are only allowed to access and interact with objects based on the permissions assigned to their user accounts or the groups they belong to.

Client domains

In the hierarchical structure of permissions, client domain permissions are positioned below system administrators but above workspace administrators and standard users. This arrangement facilitates the delegation of administrative tasks to a specific user group known as client domain admins. Unlike the System Administrator group, client domain admins have limited visibility and control confined to their designated client domain. This isolation provides more precise administrative control over a defined segment of the environment, preventing unauthorized access or changes to the overarching Relativity aiR instance.

Client domain admins possess the flexibility to adjust permission settings for various objects within their domain, customizing them to align with their specific preferences. However, these permissions are restricted solely to their allocated domain and do not extend beyond it. This boundary is designed to prevent them from accessing or modifying permissions outside their designated client domain. By implementing client domain permissions, system administrators can proficiently oversee their domain while upholding the integrity and security of the broader Relativity environment.

Violating the boundary of client domains in a system like Relativity can lead to significant risks and consequences, affecting data security, compliance, and overall system integrity. Client domains serve as isolated environments within the system, providing each client with a segregated space to manage their own data and operations independently.

User groups

User groups serve as a means to organize and manage users who need the same access or permissions. You can assign user groups at either the workspace level or the system level, based on the intended extent of access and management. When assigned at the workspace level, user groups pertain to a particular workspace, governing the permissions and access rights within that workspace. On the other hand, at the system level, user groups have wider-ranging implications and can influence permissions and access across multiple workspaces within the Relativity environment.

Feature permissions and granular permissions

Grant access with feature permissions on the Features tab whenever you can, instead of setting individual permissions on the Object Security, Tab Visibility, and Other Settings or Admin Operations tabs. A feature groups the permissions a capability needs. Each feature is made up of actions, which are the individual tasks users can perform, such as viewing, managing, deleting, or securing items. A preset is a starting set of actions that you can add to or remove from before you save.

How you manage the underlying granular permissions depends on the feature:

  • Modernized features: the granular permissions are locked, and you can change access only through the feature. All modernized features are instance-level features.
  • Non-modernized features: you can still change the granular permissions directly, and the Features tab reflects those changes. The granular permissions behind workspace-level features are not locked.

When Relativity updates how a feature's permissions are grouped into actions, the permissions your groups already have don't change. The Features tab may show the feature differently afterward, for example as partially enabled. Click See details on the feature to review which actions the group has.

The scenarios and frequently asked questions in this topic name the feature or action to grant first, where one exists. For more information, see Feature permissions.

Template groups

Workspace templates come with their own groups, called template groups. Each template group has a predefined set of permissions for a common type of user in that workspace. When you add a new group to a workspace, you can copy the permissions of a template group to it, and then preview the access it grants. For steps, see Groups.

The permissions listed for each template group are the defaults after the template is installed. You can change them at any time, so the template groups in your workspaces may differ.

Review Template groups

The Review Template includes four groups:

  • Level 1 Reviewer: for reviewers who only need to check batches in and out and review documents.
  • Level 2 Reviewer: for reviewers who, in addition to Level 1 responsibilities, need to process data, set up searches, or run productions.
  • Attorney: for users who only need to search and review documents and run search terms reports.
  • Administrator: for users who need access to all workspace functionality. This group is assigned as the workspace admin group.

To see the permissions a template group currently grants, open the group's permissions in the workspace. See Setting workspace permissions.

Other workspace templates

Other templates, such as the Investigations, Early Case Assessment (ECA), Hold and Collect, and FOIA templates, include their own template groups. For the list of templates, see Relativity aiR workspace templates.

Object-level permissions

You can employ object-level security to restrict entry to specific documents or items within the workspace. These objects encompass various components such as workspaces, documents, fields, and other elements within the system.

Tailoring access to these objects can be done on an individual user or group basis. User access determines the extent of permissions and actions a specific user can perform. Group access simplifies the management of permissions for a set of users in the same category. By managing user or group access, you can determine who is authorized to view, edit, or carry out specific actions on the objects within the system.

Furthermore, objects can have document-level or field-level permission configurations. Document-level permissions allow you to control access to individual documents based on user roles or specific criteria. Similarly, field-level permissions offer the ability to regulate access to particular fields within a document. You can set restrictions on who is permitted to view or modify specific fields based on user or group permissions.

The Manage Object Types permission grants group members the ability to:

  • Create a new tab for a new object type when adding the new object type.
  • Automatically gain view, add, edit, delete, and secure permissions for all newly created object types.
  • Automatically gain tab visibility for newly created tabs.

Item-level permissions

Item-level permissions control access to a single item in a workspace, such as one document, view, or OCR set, instead of relying on the permissions set for its object type across the workspace. With item-level permissions, you can:

  • restrict an item to specific groups. When you turn on Override Inherited Security for an item, only the groups on that item's security list can access it.
  • define what each of those groups can do with the item, such as view, edit, delete, or edit its security. Item-level permissions are most often used to give a group less access to an item than it has across the workspace, but you can also give a group more access.

When you turn on Override Inherited Security for an item, the item starts with the same permissions as the workspace-level settings for its object type. You can then change the permissions for that item. From then on, the system uses the item-level permissions for that item and ignores the workspace-level settings. For example, if a group has None for the OCR Set object at the workspace level, but you add that group to the item-level security of a specific OCR set, users in that group can view that OCR set.

To remove a group's access to an item completely, remove the group from the item using the Add/Remove Groups button. You can't set a group's access to None on an item. If a group is added to an item, the lowest level of access it can have is View.

To change item-level permission settings, you must navigate to the specific document or object and make changes individually.

Document unitization

Document unitization lets users split imaged documents into child documents. To give a group access, enable the Unitize Documents action of the Document Actions feature on the Features tab. Document unitization isn't supported when item-level security is enabled on the document.

Relativity has a current version and a legacy version of document unitization. For permissions, setup, and considerations for both versions, see Document unitization.

Scenarios

Additive permissions and Staging Explorer across workspaces

Setup:

You have two groups, Group A and Group B, and two workspaces, Workspace 1 and Workspace 2.

Group A has the instance-level Data Transfer feature, which grants access to Staging Explorer, and permission to access Workspace 1. This is your typical Client Domain Admin group.

Group B has permission to access Workspace 2. This is a typical Review group.

If a user is in both Group A and Group B, they have three permissions:

  • Permission to use Staging Explorer, granted instance-wide by the Data Transfer feature.
  • Permission to access Workspace 1.
  • Permission to access Workspace 2.
User Groups

Permissions

Access to Workspaces

Group A (Client Domain Admin)

Use Staging Explorer (Data Transfer feature, instance-wide)

Workspace 1

Group B (Review)

Access to Workspace 2

Workspace 2

User in both Group A & B

Use Staging Explorer (Data Transfer feature, instance-wide)

Access Workspace 1 & 2

Workspace 1 & 2

In this case, because permissions are additive, a user in both groups can use Staging Explorer to access the files on file shares for both Workspaces 1 and 2, even though neither group explicitly gives permissions to use Staging Explorer on the Workspace 2 file share. For more information regarding this, see the Permissions section of the Staging Explorer

Frequently asked questions

Feedback