With groups you can organize users in Relativity. A user can be a member of one or more groups. You can grant groups permission to view admin tabs from Home. You can also add groups to workspaces and set permissions per group on a workspace-by-workspace basis.

Admin and Workspace Objects diagram

This page contains the following:

System groups

Relativity workspaces include the following default system groups:

  • Everyone - All users are members of the Everyone group. System admins can manage the permissions all users have on system level views and scripts. You are unable to revoke certain permissions for the Everyone group.
  • System Administrators - Relativity system admins have rights to see every item in a Relativity environment. System admins have full access to all admin tabs. System admins can then create and edit new clients, matters, users, groups and views, among other capabilities. System admins also have the following script and applications-related permissions: view, run, preview, create/write, edit (unlocked scripts only), link, and import applications.

    Note: Regardless of permissions, system admins can't edit locked scripts.

Note: Relativity Lockbox is enabled for all RelativityOne customers. When the Relativity Lockbox feature is enabled, Relativity system admins must also belong to a group within a workspace in addition to the System Administrators group to access and administer security within that workspace. Refer to Support if you need more information on this feature.

The following table shows script permissions for each group.

  View Run Edit
(locked scripts)
(unlocked scripts)
Preview Write Link
System Admin  
Standard User        

Creating and editing groups

To create a new group or edit an existing group:

  1. Click your name in the upper right corner of Relativity, and then click Home.
  2. Click the Groups tab.
  3. Click New Group. To edit group information, click the Edit link next to an existing group name.

    Note: If your groups list doesn't show Edit links, edit the All Groups view to display the Edit link. See Views.

  4. Add or edit the fields on the group details page. See Fields for details.
  5. Click Save to save the group information.

The group details page displays a list of users added to the group as well as group-accessible workspaces. For more information, see Adding users to groups and Managing security.

Group details page showing Users and Workspaces sections

Watch the following Creating Users and Groups video for more information.


The groups object contains the following fields:

Group Information

  • Name - the group’s name, which is a required field for creating a group.

    Note: As your Relativity environment grows, arbitrary group names like "Group 1" can produce a confusing administrative workflow. Name each group according to their purpose and permission level, such as "ACME Co. Reviewer" and "ABC Corp. Administrators."

  • Client - a required field that makes the group a child object of the chosen client.
  • Group Type - an uneditable field that displays one of the following categories:
    • System Admin
    • System Group
    • Personal
    • Everyone
    • Workspace Admin
  • Keywords - an optional field where extra group information may be recorded.
  • Notes - an optional field where extra group information may be recorded.

Adding users to groups

You can add and/or remove users from groups from either the group details page or the user details page. The procedure is the same for both.

Note: A job is executed when you add users to a group or when you remove them from one.

To add or remove users:

  1. Click your name in the upper right corner of Relativity, and click Home.
  2. Click the User and Group Management tab. You can complete the following steps from either the Users or Groups tabs:
    • From the Users tab, click the name of a user and scroll down to the Groups section on the form.
    • From the Groups tab, click the name of a group and scroll down to the Users section on the form.
  3. To add a user to the group, click Add in the Users or Groups section depending on the tab.

    Group details page Add or Remove users

  4. Choose an item on the selection dialog, and click OK.
  5. Click Close on the message indicating that you have submitted a job.

    message for job submission

    Note: Relativity sends an email message notifying you when the job is completed. If an error occurs, the email message contains a link that you can use to retry the job. You must be logged into Relativity before you click the retry link. The Errors tab also displays the retry link.

  6. To remove a user from a group, click Remove. Click OK on the confirmation message, and then click Close.

    Note: You can preview the security of a group to determine whether or not the appropriate permissions are granted to that group over particular workspaces. For more information about previewing group security see Preview security.

Adding external users through groups

  1. At the instance-level, navigate to the Clients tab.

  2. Click the New Client button.

  3. Create a new client to associate the external group to and click Save.

    Note: The 'client number' field can either be the 'client name' value again, or a unique identifier.

  4. Once the new client has been created, navigate to the Group tab and select New Group.

  5. Enter a Group name to associate the external users to and connect it to the newly created client.

  6. Add any users to this group who will need access to the workspace.

  7. Next, navigate to the workspace you want to give them access to and click on Workspace Details on the right side of the screen.

  8. Select Add/Remove Groups and filter to the newly created group. Select Add, then Save.

  9. Click on the newly created group and select the Copy option. After copying permissions, you can select the Preview option to confirm what level of access they will have within the workspace.

  10. Select the template group from which you want to assign permissions.

    Note: Choices can vary depending on the workspace's template. Reviewer groups usually start with a Level 1, which grants the least permissions. More permissions are offered as the level increases. In contrast, Admin Groups often have most or all permissions within a workspace. If you are unsure, it is recommended to select the group with the lowest level of permissions. You can always copy a group with higher permissions later if you need to grant more capabilities.

Adding or removing groups from a client domain

You can add or remove objects from client domains if you activate the client domains feature.See Client domains for more information.

Note: Moving a group into a client domains may cause the group to lose previously configured permissions.

Note: Relativity displays a warning message when a sys admin attempts to edit or copy permissions for any group in a client domain. This warning makes the sys admin aware that modifying permissions may have significant consequences. For example, changing permissions may allow client domain users to modify items outside their tenancy. The sys admin can click Manage Permissions to proceed with the update or Cancel to exit the pop-up window.

Use the following steps to add a group to a client domain:

  1. Navigate to the Groups tab.
  2. Select the group you want to add to the client domain from the list.
  3. Click Edit.
  4. Click Select next to the Client field in Group Information section.
  5. Select the client with client domains enabled from the list.
  6. A warning message requires you to confirm your decision by clicking Save.
  7. Click Save.

Use the following steps to remove a group from a client domain:

  1. Navigate to the Groups tab.
  2. Select the group you want to remove from the client domains from the list.
  3. Click Edit.
  4. Click Select next to the Client field in Group Information section.
  5. Select a client not associated with a client domain from the list.
  6. Click Save.