Groups

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. See Instance security for a complete list of unrevokable permissions.
  • 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. See Relativity applications.

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

The following table shows script permissions for each group.

  View Run Edit
(locked scripts)
Edit
(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 Security and permissions.

Group details page showing Users and Workspaces sections

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


Fields

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. If your Relativity environment is configured with an SMTP server, you receive an email message when the job is completed. To use the notification feature, set the RelativityInstanceURL instance setting. Ensure that the value for this setting is the URL for your Relativity instance. For example, the URL would have the format: https://example.relativity.com/Relativity. The user receiving the notification must have access to this URL. For more information, see the Instance settings.By default, user and group operations are disabled. Contact Customer Support for information about enabling user and group operations in your Relativity environment.

To add or remove users:

  1. Click your name in the upper right corner of Relativity, and click Home.
  2. Click the Groups 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.
  4. Group details page Add or Remove users

  5. Choose an item on the selection dialog, and click OK.
  6. 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. For more information, see Errors.

  7. 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 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.