RelativityOne - User Guide
RelativityOne - User Guide
May 8, 2024
For the most recent version of this document, visit our documentation website.
Table of Contents
1 User guide overview 7
1.1 Navigation 7
1.1.1 Logging in 7
1.1.2 Tab navigation 7
1.1.3 All tabs menu 10
1.1.4 Tab strip 11
1.1.5 User options 13
1.1.6 Resetting your password 18
1.1.7 Favorites 19
1.1.8 Quick nav 21
1.2 Logging into RelativityOne 22
1.2.1 Logging in to RelativityOne with a password 22
1.2.2 Password 23
1.2.3 Two-factor authentication 23
1.2.4 OpenID Connect 25
1.2.5 SAML 2.0 26
1.2.6 Creating or resetting a password 26
1.3 SSO Troubleshooting console 27
1.3.1 Viewing the SSO Troubleshooting console 27
2 Markups 29
2.1 Highlights 29
2.1.1 Creating highlights 29
2.2 Redactions 29
2.2.1 Creating basic redactions 29
2.2.2 Creating inverse redactions 30
2.2.3 Creating full-page redactions 31
2.2.4 Creating mass redactions 31
2.3 Editing markups 32
2.4 Deleting markups 33
2.4.1 Working with overlapping markups 33
User Guide 2
2.4.2 Working with markups outside of page boundaries 34
2.4.3 Editing redaction text with a markup set 35
2.4.4 Editing redaction text 36
2.4.5 Editing font size in text box redactions 36
2.5 Mass deleting markups 36
2.6 Controlling markup visibility 37
2.7 Viewing markup history 37
2.8 Using the Markup Navigation pane 37
3 Persistent highlight sets 39
3.1 Getting started with persistent highlight sets 39
3.1.1 Showing and hiding persistent highlight sets in the Viewer 40
3.1.2 Navigating highlighted terms in the Viewer 43
3.1.3 Persistent highlight set behavior across Viewers 44
3.1.4 Persistent highlight behavior 45
3.2 Creating persistent highlight sets 46
3.2.1 Fields 47
3.3 Entering highlight terms 48
3.3.1 Color-coding persistent highlights 48
3.3.2 Guidelines for adding terms or phrases 50
3.4 Using the highlight fields source 50
3.4.1 Best practices 53
3.5 Importing search terms for persistent highlighting 54
3.5.1 Relativity component setup 54
3.5.2 Importing terms 55
3.6 Creating efficient searches for persistent highlighting 57
3.6.1 Using terms search 57
3.6.2 Using highlight fields 58
4 Search terms reports 61
4.1 Guidelines for using search terms reports 61
4.2 Creating a search terms report 62
4.2.1 Fields 62
4.2.2 Adding terms and highlight colors 66
User Guide 3
4.2.3 Editing terms and highlight colors 66
4.2.4 Deleting terms 67
4.2.5 Copying a search terms report 67
4.3 Running a search terms report 67
4.3.1 Search terms reports status 69
4.3.2 Managing errors 69
4.4 Accessing tagged documents using the Field Tree browser 71
4.5 Using tagged search terms in a saved search 72
4.6 Permissions 73
5 Searching overview 76
5.1 Filters 76
5.2 Keyword searches 76
5.3 Saved searches 76
5.4 dtSearches 76
5.5 Analytics 76
5.6 Regular expressions 77
5.7 Additional features 77
5.8 Search conditions 77
5.8.1 Setting up search conditions 78
5.8.2 Canceling queries 79
5.8.3 Frequently asked searching questions 80
6 Tabs 82
6.1 Creating and editing tabs 83
6.2 Fields 83
6.2.1 Tab Information 84
6.2.2 Tab Location 85
6.3 Nesting children tabs 86
7 Viewer 87
7.1 Native Viewer 89
7.1.1 Navigating the Native Viewer 89
7.1.2 Copying text in the Viewer 95
7.1.3 Streaming audio and video files 95
User Guide 4
7.1.4 Document Intelligence 97
7.2 Image Viewer 100
7.2.1 Navigating the Image Viewer 100
7.2.2 Saving an image as a PDF 105
7.3 Extracted Text Viewer 105
7.4 Productions Viewer 110
7.4.1 Navigating the Productions Viewer 110
7.4.2 Imaging on the fly 115
7.5 PDF Viewer 115
7.6 Document actions menu 120
7.7 Viewer settings menu 122
7.8 Pop Out Viewer 123
7.8.1 Standalone Viewer 125
7.8.2 Document preview panel 126
7.9 Related items card 127
7.10 Document and Production History card 129
7.11 Documents card 130
7.11.1 Email thread visualization tool 131
7.12 Thumbnail Viewer 131
7.13 Document compare 132
7.14 Viewer-supported file types 134
7.14.1 Text only designation 135
7.14.2 File ID only designation 135
7.14.3 Supported File ID-only file types 135
7.14.4 Supported Text-only file types 136
7.14.5 Supported File types 137
7.14.6 Viewer audio and video-supported file types 149
7.14.7 Troubleshooting errors 150
7.14.8 Supported audio file types 150
7.14.9 Supported video file types 151
8 Workspaces 154
8.1 Viewing workspace details 155
User Guide 5
8.2 Migrating and retrieving workspaces to and from cold storage 156
8.2.1 Migrate workspaces to cold storage 156
8.2.2 Retrieve workspaces from Cold Storage 158
8.3 Workspace admin group 159
8.4 Document and item list navigation 160
8.4.1 Browsers panel 160
8.4.2 View bar 163
8.4.3 Document Preview panel 164
8.4.4 Item list 166
User Guide 6
1 User guide overview
When working with Relativity as a reviewer, it's important to familiarize yourself with the software's many
features.
This guide outlines Relativity’s capabilities and walks you through how you can best use Relativity for
document review, from logging in to creating a word index inside a workspace.
1.1 Navigation
Relativity is an application with many screens and functions. This section describes the Review Interface
you use to review documents and some of the standard procedures you'll need to perform as you use the
product.
1.1.1 Logging in
Relativity offers several ways to log in and it's possible to have two or more methods available to you. Your
system admin will provide you with all the information you need to log on. Contact your system admin if you
have additional questions.
For procedures to log in, see Logging in to Relativity.
1.1.2.1 Sidebar
The sidebar allows you to place tabs that you commonly use on the left-side of Relativity so that you can
access them at your convenience.
User Guide 7
Tabs are ordered from top to bottom of the sidebar based on the value entered in Order. The lowest order
value displays at the top and the highest value displays at the bottom.
The total number of tabs that display in the sidebar is determined by the resolution of your browser. Tabs
that have been assigned to the sidebar and do not fit, are available by hovering your cursor over the More
icon. If a tab has one or more child tabs, you can view and select those tabs by hovering over the parent
tab's row in the fly-out menu.
User Guide 8
The More icon will display with an orange bar on the right side More to indicate that the active tab is located
in the More menu.
To add a new or pre-existing tab to the sidebar, toggle the Show in Sidebar on and click Save.
Tabs can display in the sidebar with their name and icon. Alternatively, to reduce the width of the sidebar
and increase the number of icons that can display, you can click the collapse arrow icon to only display the
icon for each tab.
User Guide 9
1.1.3 All tabs menu
Click the icon at the bottom of the sidebar to display the All tabs menu. Every child tab that a user can
view, as determined by their permissions, will display in the menu in alphabetic order. This menu does not
display parent tabs.
User Guide 10
1.1.4 Tab strip
If you select a tab that either has child tabs or is a child tab to a parent tab, the tab strip will display
horizontally across the top of Relativity. If a tab in the tab strip has one or more children tabs, hover your
cursor over it to view and select the desired tab. Depending on the size of your browser, there may be more
tabs than can display in the tab strip. You can hover your cursor over More in the tab strip to view additional
tabs in a fly-out menu.
User Guide 11
1.1.4.1 Parent and child tab display
Parent tabs can be displayed in the sidebar or the tab strip. Tabs that have child tabs in the tab strip will
display with an arrow on the right side.
To view the child tabs of a parent tab in the sidebar or tab strip, hover your cursor over the parent tab and
the child tabs will display in a fly-out menu.
User Guide 12
When you select a child tab from the sidebar or the tab strip, you are taken to that page. For example,
Production Sets. In addition to an orange bar displaying underneath the parent tab in the sidebar, the child
tab and the path to reach the active tab is highlighted in blue to help you track your location in the sidebar or
the tab strip.
Instead of clicking the drop-down arrow, you can also click the parent tab itself. Clicking the parent tab takes
you to the default child tab, which is identified by the order setting for each child tab.
User Guide 13
1. Navigate to the Tabs tab.
2. Click on the tab you want to set as the default Home tab.
Note: If a user is not a member of a group with permission to view the tab set as the default Home tab,
Relativity redirects to the lowest ordered tab the user's permissions allow.
1.1.5.2 My settings
Clicking My Settings from within the user drop-down menu opens a settings mode pop-up, which displays
your user information. Click Edit to change your settings.
Note: Your first and last name appear as your username throughout Relativity.
n Default Filter Visibility—determines whether or not the filters for columns in views display by
default.
o Hidden—hides filters by default.
o Visible—displays filters by default.
n Item list page length—a numeric field indicating the default list length for all lists in Relativity. It can
be set from 1-200.
User Guide 14
n Default Selected File Type—the default viewer mode used when first loading the Viewer. Viewer,
Native, Image, Long Text, or Production. If the mode selected is not available, the Viewer will instead
use the first available option. See Viewer on page 87 for details.
n Default Saved Search Owner—determines whether saved searches are public or private by
default. If set to Public, the search is public and all users with rights to it can see it. If set to Logged in
User, the search is private and only the logged in user is able to see it.
Note: Depending on your permissions, you may not have rights to edit the Default Saved
Search Owner field.
n Native Viewer Cache Ahead—if checked, this field pre-loads the next native document in your
review queue when the active document is loaded.
n User-Group Email Notifications—user's preference for email notifications when adding or deleting
Users or Groups.
o All Emails—receive all email notifications.
o No Emails—receive no email notifications.
o Only Failed Operations—receive email notifications on failed operations only.
Note: Depending on your permissions, you may not have rights to edit the User-Group Email
Notifications field.
1.1.5.3 Dashboards
When you've created a page configuration you'd like to preserve, you can create a customized dashboard.
You can save multiple dashboards to quickly change the page configuration. The item list and any widgets
on the dashboard will update automatically in response to filtering or searching. Dashboards only report on
data within the workspace you are in.
Note: For a list of dashboards that provide an effective starting point for administrators to help review
teams visualize their data set, see Common commonly-used dashboards in the Admin Guide.
User Guide 15
The page initially appears with the folder browser on the top left, the search panel on the bottom left and the
item list to the right. Within this new framework, you have multiple options for customizing your display.
You can resize, move, or collapse any panel on the page, including any widgets you create.
n To resize any panel, hover over the line separating the item list from the panel until you see the
mouse pointer change to horizontal arrows, then click and drag.
n
To move, hover over the top of the panel until you see the icon. Then, click and drag the panel to
the new location.
n
To collapse the search panel or browser pane, click the icon. Once collapsed, click the icon to
restore the browser pane or the icon to restore the search panel.
Additionally, you can drag and drop panels to rearrange on the page. Click any panel and drag it to a new
location. The other panels will automatically move to accommodate the panel you're dropping.
Dashboards and widgets can be copied over to newly created workspaces if they are part of a template.
Dashboards only report on data within the workspace you are in if data is loaded in the workspace.
Note: You must have the correct workspace permissions to add, edit, or save a dashboard and to save
pivot widgets to your dashboard.
You can also export individual Pivot widgets to Excel or to PNG format from each widget's context menu.
See Exporting a Pivot widget in the Admin Guide for more information.
User Guide 16
Note: To enable the Add Widgets button and Pivot functionality for an Relativity Dynamic Object (RDO),
you must select Enabled for the Pivot property in the Object Type Information section for the object.
Creating a dashboard
To create a dashboard:
1. Click the Dashboards drop-down menu in the top right corner of the screen.
Note: You can only access the drop-down if Pivot is Enabled for the given object type.
2. Click New Dashboard to save the current page configuration as a new dashboard.
3. Enter a name and an order number for the dashboard.
Note: The dashboard with the lowest order number will appear by default when you log in to Relativity.
n Pivot charts and tables—you can use Pivot to summarize data in tables or charts to visually ana-
lyze trends in your data.
n Cluster visualizations—on the Documents tab, you can use Relativity Cluster Visualization to
render your cluster data as an interactive visual map by adding a Cluster Visualization widget. This
offers you a quick overview of your document cluster sets and quickly drill into each cluster set to view
sub-clusters and conceptually-related clusters of documents. Please note that there may be only one
cluster visualization widget per dashboard.
n Communication Analysis—after running the name normalization operation within structured ana-
lytics, you can use this widget to visualize communication frequencies, patterns, and networks
between the entities linked to the documents in the view.
Note: When you reach the maximum number of widgets allowed on a dashboard, the Add Widget button
will be grayed out and a tooltip displays when you hover over it that lets you know the reason you cannot
add any additional widgets to your dashboard. This is controlled by the MaxNumberDashboardWidgets
instance setting.
1. Click the Dashboards drop-down menu in the top right corner of the screen to display the list of dash-
boards available on the current tab.
2. Click Save to save the changes to the existing dashboard. Click Save As to save the page con-
figuration as a new dashboard, and then enter a Name and Order number.
User Guide 17
Note: If a dashboard is part of a locked application, the option to save the dashboard is unavailable.
Deleting a dashboard
To delete a dashboard from the current tab you are in, click the icon to the right of the dashboard you want
to delete in the Dashboards drop-down menu.
Click Delete in the Delete Dashboard Confirmation pop-up window to delete the dashboard.
Note: If a dashboard is part of a locked application, the option to delete the dashboard is unavailable.
Renaming a dashboard
To rename a dashboard:
1. Click on the icon next to the name of the dashboard in the Dashboard drop-down menu.
2. Enter a Name and an Order number for the dashboard. The order number controls the order in which
the dashboard displays in the list.
3. Click Save to save your changes.
Note: If a dashboard is part of a locked application, the option to edit the dashboard is unavailable.
Note: If your password has expired, the Reset Password dialog appears automatically when you log in to
Relativity. Your system admin determines when your password expires and the number of previous
passwords that you cannot reuse.
User Guide 18
You can use your new password next time you log in to Relativity.
Relativity sends an email to the address you provide. You should receive this message within a few
minutes. If you do not receive an email, check your spam or junk mail folder.
3. Click the link in the email to reset your password. This link will be active for 15 minutes and expires
after that time. If the link has expired, or if you click the link more than once, you'll have to generate a
new password reset request.
4. The link directs you to a page where you can create a new password.
5. Enter a new password and retype it, then click Submit. After your password successfully resets,
you'll get a message prompting you to log in with your new password. An email will be sent to the
address you entered, notifying you that your password reset was successful.
1.1.7 Favorites
The Favorites menu contains all your bookmarks (Favorites) and the last 10 pages in your browsing history
(Recents). The Favorites menu can be accessed by clicking the icon in the upper-right part of the
page.
User Guide 19
Use Favorites to quickly navigate the Relativity application. If you visit a particular page on a regular basis,
minimize the number of clicks it takes to get there by adding the page as a favorite.
To mark a page as a favorite, click the star to the right of the breadcrumbs at the top of the page. The star
turns yellow and Relativity adds the page to the Favorites section. Relativity doesn't limit the number of
pages you can mark as a favorite.
Relativity records pages in the Recents section on each page load. That means that pop-up windows aren't
recorded as Recents.
User Guide 20
Note: If you're a system admin, you can turn off this feature by editing the RecentHistoryEnabled and
FavoritesEnabled instance setting values. You can also change the number of Recents the Favorites
menu displays by editing the RecentHistoryNumberOfItemsDisplays instance setting value.
Note: Verify that the quick nav Ctrl+/ keyboard shortcut works on custom pages. Contact Customer
Support with any problems.
Open quick nav, and type the name of any tab or workspace.
Any tab or workspace that contains the character string within the name appears in the list of results.
Results appear after you type more than one character, and they refine with each character you type. The
results link you directly to the tab or workspace in Relativity.
Note: In Relativity terms, the search works the same as a leading and trailing wildcard search.
You can click on any result or use the up and down arrow keys to move through the results. Press Enter to
navigate to the selected item.
Your search remains until the page is refreshed or you navigate to a new tab. The Esc key also clears your
search from quick nav. If no text is entered in the quick nav search field, the Esc key closes quick nav. You
can also click anywhere outside the quick nav window to close it.
Quick nav displays three types of results in the following order:
User Guide 21
n Workspace tabs—lists all workspace tabs that fit the search criteria and are available with your per-
mission settings.
n Admin Tabs—lists all admin tabs that fit the search criteria and are available with your permission
settings.
n Workspaces—lists all workspaces that fit the search criteria and are available with your permission
settings. Click the workspace to go to the default tab for that workspace.
Quick nav results only reflect items available with your permission settings.
n Type the word "home" in quick nav to navigate to your default Home tab.
n Quick nav is enabled or disabled with the QuickNavEnabled instance setting.
n Quick nav is available to look up workspaces and admin tabs from Home for groups assigned the Use
Quick Nav admin permission, and it is available to look up tabs in a workspace for groups assigned
the Use Quick Nav workspace permission.
n The maximum number of returned quick nav search results is limited to any number between 2-50,
but the default is 20.
n The maximum number of searchable characters is 50.
Note: For help with single sign-on errors, please see the SSO Troubleshooting console on page 27.
User Guide 22
Note: The Forgot your password? link only displays if the admin enables Allow Password Recovery via
Email setting, for more information see the Authentication Guide.
1.2.2 Password
This method uses only a username and a password. Your RelativityOne admin provides you with the
following:
User Guide 23
3. On the Two-Step Verification Required step, click Continue.
If you are unable to scan the QR code, click the Can't scan QR code? link below the QR code. Once
clicked, a code will appear. Enter the code into your authenticator app on your phone. Once entered
into the authenticator app, you can continue to the next step.
7. Click Next.
8. Re-enter your email and password.
9. Enter the authentication code in the app.
10. Click Next.
11. Click Done.
To log in with an authenticator app method:
User Guide 24
1. Navigate to the RelativityOne site.
2. Log in with your password.
3. Follow the instructions on the app or enter the authentication code from the authentication app.
4. Click Next.
To log in with the Relativity email method:
4. Click Login.
User Guide 25
1.2.5 SAML 2.0
This method requires you to have an account with SAML 2.0 authentication provider set up by your
RelativityOne admin. Your admin provides you with a Relativity account with a SAML 2.0 login method.
To log in:
Note: If you are a system admin, the Password Reset Email will not be sent to you. For more information,
see the Authentication Guide.
1. Within the password request email, click Reset Password or enter the full URL into your browser.
2. Enter a password following the restrictions listed on the screen. You must remember this password to
log in. The link within the email is valid for 15 minutes, and you can only use the most recent email.
Although, once the password is set, you do not have to log in immediately.
Note: The following non-alpha-numeric characters are not allowed: \, ", <, >, £ in passwords.
User Guide 26
3. Click Submit.
4. Click Return to RelativityOne.
Considerations
n This console should not be utilized for auditing purposes.
n You must have the Edit permission on the Authentication Provider object to view the console.
n The error log will only show the 10 most recent error messages.
User Guide 27
3. Review the errors and make the necessary updates to resolve the issue.
4. Once the errors have been resolved, clear the error log.
User Guide 28
2 Markups
Markups in Relativity refer to highlights and redactions. You can add markups to documents that contain an
image using the Image Viewer. When you open a document in the Native Viewer that has not been imaged,
select Image on the Fly from the Document actions menu to image the document which can then be
opened in the Image Viewer.
Note: If two people edit a markup at the same time, an error occurs.
2.1 Highlights
When you create a highlight, a colored box appears in the area you select, just like using a highlighter.
1. Click .
Blue is the default color. Click the drop-down menu to select a different color.
2. Draw the highlight across the sections of text you want to highlight.
When you create a highlight, it appears in the Markup Navigation Pane. See Using the Markup Navigation
pane on page 37.
2.2 Redactions
A redaction hides text on a page. In Relativity, you can create several different types of redactions:
1. Click .
The black redaction tool is the default. Click the drop-down menu to select a different tool. You can
select from the following:
n Black Redaction—creates a solid black box, like using a black marker. While you draw the
box, a gray translucent fill appears.
User Guide 29
n Cross Redaction—creates a white redaction box black border and a black X from corner to
corner.
n Text Redaction—creates a white redaction box with black text. The text will fill the box by
default. To change the font size, keep the redaction box selected and click , and
then select a new font size from the drop-down menu. You can right-click a text box redaction
to apply different text. See Editing redaction text on page 36. The system admin determines
which text options are available.
n White Redaction—creates a solid white box with a gray border. The gray border does not
print or produce.
2. Draw the redaction boxes across the sections of the page you want to redact. You can draw in any dir-
ection.
1. Click the Redaction Mode icon and select Inverse Redact from the drop-down menu.
2. Draw the inverse redaction boxes across the sections of the page you do not want to redact.
A blue cast indicates where you will add the black redaction, and the white box indicates the area that
is not redacted. You can move or re-size the white box using the controls. You can also highlight text
that is not redacted.
User Guide 30
2.2.3 Creating full-page redactions
A full-page redaction creates a redaction across the entire page. To apply a full-page redaction, click the
Redaction Mode icon and select Full-Page Redact from the drop-down menu. The black full page
redaction tool is the default. Click the Redaction Type drop-down menu to select a different tool. You can
select from the following:
n Black Redaction—creates a solid black box, like using a black marker.
n Cross Redaction—creates a white redaction box with a black border and a black X from corner to
corner.
n Text Redaction—creates a white redaction box with black text. You can right-click a text box
redaction to apply different text. See Editing redaction text on page 36. The system admin determines
which text options are available.
n White Redaction—creates a solid white box with a gray border. The gray border will not be printed or
produced.
You can also create a keyboard shortcut to apply a full-page redaction. See Creating keyboard shortcuts in
the Admin guide.
After you apply a full-page redaction, you can resize it to make it smaller than the full page and then work
with it like a normal redaction. Additionally, you can create new redactions on top of a full-page redaction if
desired.
1. Click the Redaction Mode icon and select Mass Redact from the drop-down menu.
The Mass Redact Options pop-up appears.
User Guide 31
2. Select the type of redaction to apply. You can select from the following:
n To re-size a markup in a larger increment, press Shift + the arrow key on your keyboard that
points in the direction you would like to expand the markup.
n To re-size a markup in a smaller increment, press Ctrl + Shift + the arrow key on your
keyboard that points in the direction you would like to expand the markup.
You can move markups individually or as a set. To select multiple markups on a page,
User Guide 32
click the selector tool and drag across the markups. Alternatively, press Shift or Ctrl and click to select
individual markups, or click Ctrl + A to select all markups on an image. Controls appear on the corners and
edges of all selected markups.
To move, click and drag the selected markups to a new location. You can also move selected markups
using the arrow keys. To move a markup in a larger increment, press the arrow key on your keyboard that
points in the direction you would like to move the markup. To move a markup in a smaller increment, press
Ctrl + the arrow key on your keyboard that points in the direction you would like to move the markup.
1. You can use any of the following methods to select markups for deletion:
n Left-click and drag the selection box over the markups you wish to delete.
n Hold down on Ctrl on your keyboard, and left-click on each markup you wish to delete.
n Right-click on a markup after selecting any other markups you would like to delete.
2. Select Delete from the right-click menu.
The Delete Markups modal displays.
3. Verify that you wish to delete the number of markups displayed in the modal and click the Delete X
Markups button.
The selected markups are deleted.
Note: If you have a full-page redaction applied to an image, then you apply an additional full-page
redaction, the most recently applied full-page redaction appears on top. If you then delete the second
redaction, the first full-page redaction persists.
User Guide 33
2.4.2 Working with markups outside of page boundaries
If you have markups that exist outside the boundaries of an image, such as those created by custom
applications, they will render in their currently saved coordinates in the Viewer. Interacting with the markup
by attempting to move or select it will move the markup within the page boundaries. This change is saved
and audited in the workspace.
User Guide 34
2.4.3 Editing redaction text with a markup set
When you create a text redaction, it will display the most recent word or phrase you entered while editing a
redaction. If you have never edited or created a text redaction before, it will display Redacted instead.
To perform this task you need the permissions for the markup sets object as well as the individual markup
set you wish to use.
To edit the text in a text box redaction using the default text for a markup set:
1. Choose the desired markup set from the drop-down list in the bottom-left corner of the Viewer.
2. Right-click the redaction and select the default redaction text from the markup set.
User Guide 35
2.4.4 Editing redaction text
To edit the text in a text box redaction, perform the following steps:
2. Enter the new redaction text in the field and click Edit Redaction.
The new text appears in the redaction. Any new redactions you create will display the same text until
you edit a redaction or use the default Redacted option.
1. Click .
The Mass Delete Markup pop-up appears.
User Guide 36
2. Select the markup types you want to delete. You can select Non full-page redactions, Full-page
redactions, Highlights, or any combination of these.
3. Select the range of pages from which to delete the selected markups. You can select Current page,
Pages, enter a set of pages, or All pages in document.
4. Click Delete Markups. The selected markup types are deleted from the range of pages you selected.
User Guide 37
in the lower left corner of the viewer. The Markup Navigation pane displays a list of all redactions and
highlights that reviewers created in the document, as well as references to their page numbers and parent
markup sets.
You can click anywhere on the markup row to jump to the page where the markup occurs. In addition,
Relativity updates the active markup set to the one associated with your row selection in the Markup
Navigation pane.
User Guide 38
3 Persistent highlight sets
With persistent highlight sets you can configure and apply term highlighting to assist with document review
in the Viewer. In the Persistent Highlight Sets pane of the Viewer, you can see all sets saved in a workspace
and apply or hide term highlights in the document you are reviewing.
If a document you are reviewing contains any of the terms specified in a set, the list of terms and the number
of times they appear in the document appear under the set. If a document contains no terms from the set,
you can not expand or collapse the set in the tree. If the document contains some terms in the set, only the
terms that exist in the document appear below the set name.
System admins can control which highlight sets different users see when working within a document. See
Workspace security in the Admin guide.
Persistent highlight sets are independent of markup sets. See Markup sets in the Admin guide.
User Guide 39
The following persistent highlight set includes several terms with highlight color-coding. See Color-coding
persistent highlights on page 48 for more information.
This set is available when a user opens the viewer and any edits made to this set are reflected immediately.
Click the next to a persistent highlight set to expand it and show the list of terms from that set found in the
document. By default, all persistent highlight sets are enabled in the Viewer, and terms found in a document
are selected in the Persistent Highlight Sets pane and highlighted in the document. Click a persistent
highlight set's name or the icon to hide all term highlights from the set in the Viewer. When a persistent
highlight set's icon is and the terms appear partially transparent in the Persistent Highlight Sets pane,
the term highlights for the set are hidden in the Viewer.
User Guide 40
Clear a term's check box to hide its highlights in the Viewer. Select its check box to apply highlighting for the
term in the Viewer again.
If any of the set’s terms are not present in the current document open in the Viewer, they do not display in
the Persistent Highlight Sets pane. For example, if you created a set named Investments that contains five
highlight terms, and only three of the terms show in the pane for a particular document, the other two terms
are not present in the document.
You can navigate through the hits for a persistent highlight set or for a term while viewing a document in the
Viewer. Click on either the persistent highlight set or the desired term in the Persistent Highlight Sets pane
and the Go to Next/Previous Highlights icons display in the row.
You can use the Next/Previous icons to cycle through the hits for either the persistent highlight set or the
highlighted term. Regardless of where you are in a document, when you click the Next icon for the first
time, you will be taken to the first highlight in the document for that persistent highlight set or term. Even if
you have moved past it while browsing the document.
Clicking the Next/Previous icons also emphasizes the actively navigated highlight with an orange glow to
help you track which one is active.
User Guide 41
When you select a persistent highlight term in the Persistent Highlight Sets pane, in addition to highlighting
all instances of that term in the body of an email, the Viewer also highlights instances of the term in the email
header.
The number of terms and hits is listed to the left of the persistent highlight set's name. It is possible to have
many highlight sets enabled but no highlights appear in a document.
Selections made in the Persistent Highlight Sets pane persist throughout a user's session in Relativity. This
includes any of the following changes related to the Persistent Highlight Sets pane in the Viewer:
User Guide 42
n Expanding or collapsing the term list for a persistent highlight set.
n Checking or clearing terms check boxes in a persistent highlight set.
Note: Beginning in Relativity 11.3.1, the auto-contrast feature has been added to color-coding persistent
highlights. This feature automatically determines the text color based off the background color you select
to ensure readability no matter which colors are selected. For example, if the background color is closer to
black, the text will automatically be white or if the background color is closer to white, the text will
automatically be black.
Note: The opacity level of the highlights for proximity searching and inactive terms can be adjusted by
editing the value of the ViewerHighlightStyleDefault instance setting.
User Guide 43
Color name Highlight Color Number
[Default] 0
Black 1
Dark red 2
Dark green 3
Dark yellow 4
Dark blue 5
Dark magenta 6
Dark cyan 7
Light gray 8
Gray 9
Red 10
Green 11
Yellow 12
Blue 13
Magenta 14
Cyan 15
White 16
Light green 17
Light blue 18
Light yellow 19
Light purple 20
Light red 21
Light orange 22
Purple 23
Orange 24
Dark purple 25
Dark orange 26
User Guide 44
n Any changes made to a persistent highlight set tree in the panel when the Viewer is undocked, such
as terms selected or unselected, will display when the Viewer is docked again.
n A synced standalone Viewer will not display changes made to a persistent highlight set, such as
terms selected or unselected, in the pane of the main Viewer. However, Persistent Highlight Sets
pane settings remain the same in the standalone Viewer as the reviewer goes from doc to doc within
the standalone Viewer.
n The Persistent Highlight Sets pane maintains its current state when you swap Viewer panes.
n The Persistent Highlight Sets pane in the Extracted Text Viewer and Native Viewer are independent
of each other. A change made to the pane in the Extracted Text Viewer is not automatically reflected
when the reviewer switches to the Native Viewer and back.
n Advanced persistent highlighting, available when using a search term report as a highlight field
source, is only available in the Native and Extracted Text Viewer. See Using the highlight fields
source on page 50.
See the Viewer documentation in the Admin Guide.
User Guide 45
3.2 Creating persistent highlight sets
To create a new persistent highlight set, follow these steps.
Note: If you plan to use the Source: Highlight Fields, you may need to create a search terms report. For
more information, see Using the highlight fields source on page 50.
User Guide 46
1. Navigate to the Persistent Highlight Sets tab.
2. Click New Persistent Highlight Set.
3. Complete all required fields in the Persistent Highlight Set Information section. See Fields below for
details.
4. Click Save.
Note: Verify that reviewers are not actively reviewing documents when creating persistent highlight sets.
Creating persistent highlight sets while reviewers are actively reviewing documents can cause errors.
3.2.1 Fields
Persistent highlight sets include the following fields.
n Name- the descriptive name under which you want this set to appear in the Viewer and item list.
n Order -the order in which you want this set to appear.
n Source - determines the area the set draws from when designating characters to be highlighted and
displayed in the Viewer. There are two options:
o Highlight Fields - designates fields as the source of highlighting. Highlight Fields is capable of
using dtSearch functionality. Selecting this radio button means you must select a Highlight
Field in order to save this set.
o Terms- designates terms as the source of highlighting. Selecting this radio button means you
must enter terms into the Terms field below to save this set.
n
Highlight Fields- choose the field referencing the list of terms to be highlighted. Click the
button to bring up the system view called Field Picker on Persistent Highlight Sets, which displays the
User Guide 47
Name and Object Type for applicable multiple object fields. It also includes those created by search
terms reports. To select the desired Highlight Field, check the field’s box, click Add, and click Set. The
field displays on the layout. See Using the highlight fields source on page 50.
Note: If your search terms report is run against a dtSearch index with a customized alphabet file,
the hits on the STR may not match the highlights rendered in the Viewer. Depending on how the
alphabet file has been customized, you may see fewer highlight hits rendered in the Review
Interface.
n Terms - enter terms you wish to highlight and select the color code to distinguish them in the Viewer.
See Entering highlight terms below.
Note: Beginning in Relativity 11.3.1, the auto-contrast feature has been added to color-coding persistent
highlights. This feature automatically determines the text color based off the background color you select
to ensure readability no matter which colors are selected. For example, if the background color is closer to
black, the text will automatically be white or if the background color is closer to white, the text will
automatically be black.
User Guide 48
Highlights are rendered at full opacity (using the original highlight color) when they are active. When they
are not active, they will be rendered in a lighter shade of the original highlight color.
Note: The opacity level of the highlights can be adjusted by editing the value of the
ViewerHighlightStyleDefault instance setting.
User Guide 49
Note: Default has different implications for text and background. The default background color is white
and the default text color is black.
n Enter a term that you want highlighted and press Enter. You can enter multiple terms but each one
must be on a separate line.
n Enter terms for persistent highlighting exactly as they appear in the document. Don't use quotation
marks and connectors.
Note: Quotation marks are not compatible with persistent highlighting with terms as a source,
which automatically searches for an exact phrase. Quotation marks are compatible when using
highlight fields as a source however. Using highlight fields as a source can result in slower
document loading speeds.
n Keep lists simple. Do not use punctuation, special characters, or operators. Do not use dtSearch syn-
tax when entering a list of terms as the source for the set. You may use dtSearch index terms in a
search terms report, then use Fields as the Persistent Highlight Source instead to support highlights
for dtSearch syntax.
o AND or OR operators are not used in keyword searching. If used, Relativity looks for the exact
phrase including AND or OR. For example, you entered these search terms: Apple AND
Banana. Relativity highlights the entire phrase apple and banana in the document. Separate
occurrences of apple, and occurrences of banana, are not highlighted.
o Persistent highlight set terms do support wildcards. You can view highlighted terms that con-
tain an * (asterisk) character, including a wildcard in the middle of a term. For example:
l term* matches and highlights any word that starts with term with zero or more following
characters.
l *term matches and highlights any word that ends with term with zero or more preceding
characters.
l *term* matches and highlights any word that has term in it with zero or more preceding
or following characters.
User Guide 50
Select the Highlight Fields option, and then click the button to open the Select items - Highlight
Fields modal. This system view displays the Name and Object Type for applicable multiple object fields,
including those created by Search Terms Reports.
Note: Persistent highlights generated by a search terms report don't automatically update after you load
new data into a workspace. To incorporate the text from new documents, perform either a full or
incremental build on the dtSearch Index, then a full or incremental build on the search terms report.
To select a Highlight Field, check the field’s box, click right arrow to move it the right section. Once all of the
desired fields have been selected, click Apply. The field appears on the layout.
Note: We recommend selecting a search terms report or the Domains field as your highlight fields source.
When using a Search Terms Report as the highlight fields source, the number of terms that Relativity
searches for will vary among different records. Relativity only looks for the terms listed in the Search Terms
Report for that document.
User Guide 51
Relativity exhibits similar behavior when using an email Domains field as the highlight fields source.
Relativity only looks for the email domains listed in the field for that document.
User Guide 52
3.4.1 Best practices
Consider the following guidelines when creating or adding terms using Search Terms Reports as the
highlight fields source:
User Guide 53
o Persistent highlight does understand proximity searching. If you enter the phrase Relativity w/5
software as a search term, the search term report uses a dtSearch to find and tag all doc-
uments that meet the criteria. When viewed in the Viewer, the persistent highlighting functions
as a dtSearch.
o Persistent highlights does understand the stemming character (~). If you enter the term apply~
as a search term, the search term report finds and tags all documents with the word apply, or
any document that stems from apply; including applied, applies, application, and so on. When
looking at the document in the Viewer, the persistent highlight functions as a dtSearch. See
Search terms reports on page 61 for information on supported syntax.
o Any operator in quotes will be treated as literal by the Viewer search. For example, stemming
“~” and wildcard “*” operators. However, dtSearch will treat stemming and wild card operators
in quotes not as literal, but as the operator itself. For example, "run~” in the Viewer will find the
exact phrase “run~” and "run~” in dtSearch will return hits for run, runner, running, etc.
User Guide 54
a. Object Type- Document
b. Name- <User preference>
c. Field Type- Multiple Object
d. Associative Object Type- <Dynamic Object created in step 2>
e. Keep all remaining properties at their default values.
f. Click Save.
7. Navigate to the Persistent Highlight Sets tab in your workspace.
8. Click New Persistent Highlight Set.
9. Create a new set with the following properties:
a. Name- <User preference>
b. Order- <User preference>; this controls the position of this set in the Persistent Highlight Tree
in the Viewer.
c. Source- Highlight Fields
d. Highlight Fields- <The name of the field created in step 6b.>
e. Click Save.
User Guide 55
Color name Highlight Color Number
Dark yellow 4
Dark blue 5
Dark magenta 6
Dark cyan 7
Light gray 8
Gray 9
Red 10
Green 11
Yellow 12
Blue 13
Magenta 14
Cyan 15
White 16
Light green 17
Light blue 18
Light yellow 19
Light purple 20
Light red 21
Light orange 22
Purple 23
Orange 24
Dark purple 25
Dark orange 26
User Guide 56
16. Set the Link View field to your preferred document view.
17. Click Save.
18. Click Link.
19. Select all documents.
20. Click Add.
21. Click Set.
22. Repeat steps 10 through 22 on each term.
23. Verify that the terms are highlight through the following:
a. Open a document in the workspace.
b. Open the Persistent Highlight Tree in the Viewer.
c. Note the presence of the newly created Persistent Highlight Set and verify that terms are high-
light in the appropriate colors.
User Guide 57
n Do not use "AND" or "OR" connectors. Persistent highlighting looks for the exact phrase, trade and
complete, instead of the word, trade, and the word, complete.
n Proximity, fuzziness, and stemming logic cannot be used in a Terms Search. Consider using High-
light Fields to access these search features as described below. The system ignores the dtSearch
syntax. Terms receive no highlight if you use these advanced searching features. The search terms
report Count column still lists the number of matching terms. For example:
o The search term, oil w/10 water, searches for the exact phrase oil w/10 water.
o If you enter the term apply~ as a search term, persistent highlighting technology looks for the
term apply followed by any special character.
n Avoid using terms with a large number of hits per document. Persistent highlighting highlights each
hit. For example, it takes longer to load a Word document containing 1,000 instances of a single term.
n Avoid using terms that only occur once in a document. Use search terms reports for those terms
instead.
n Avoid long lists of numbers, such as Bates numbers or account numbers.
n Do not use duplicate terms.
Use the following techniques to optimize your searches:
n Use the dtSearch Dictionary to identify variations of a term instead of using wildcards.
o Identify which terms should be in the highlight set and which terms are not necessary.
o You may want to avoid highlighting terms with high word counts.
Note: To highlight terms using objects, create a fixed-length text field for your object called Highlight
Colors. You can enter color-coding in this field using the format: [highlight color];[text color].
User Guide 58
n Enter terms exactly as they appear in the document.
n You can use operators such as AND and OR. For example, if you enter these search terms: Apple
AND Banana, Relativity would highlight the two terms “apple" and "banana” in the document. See
Search terms reports on page 61 for more information.
n Wildcards are useful in some cases. For example, the search term appl* highlights apple, application,
applies, and so on. An excessive use of wildcards affects performance. Leading wildcards such as *it-
ting, are not recommended. Using asterisks in the middle of a term don't count as wildcards.
n dtSearch operators can be used to highlight searches when used for a Persistent Highlight Sets in the
Native Viewer. You must use a Highlight Fields source (such as a Search Terms Report results field)
to use dtSearch syntax. Relativity dtSearch operators are not supported in the Extracted Text Viewer.
The highlights for these searches use the active and inactive highlighting functionality. Actively nav-
igated highlights are the highlights that the Viewer is focused on and display with full opacity. Inactive
highlights display at a lower opacity level.
o Proximity searching logic can be used with Highlight Fields. If you enter the phrase "Relativity
w/5 software" as a search term, the search term report uses a dtSearch to find and tag all doc-
uments that meet the criteria. When viewed in the Viewer, the persistent highlighting functions
as a dtSearch. See Search terms reports on page 61 for information.
o Stemming, including the stemming character (~), can also be used with Highlight Fields. If you
enter the term "apply~" as a search term, the search term report finds and tags all documents
with the word apply, or any document that stems from apply; including applied, applies, applic-
ation, and so on. When looking at the document in the Viewer, the persistent highlight functions
as a dtSearch. See Search terms reports on page 61 for information.
User Guide 59
n In Search Terms Reports, you can the Dictionary Search function to identify search terms using stem-
ming or fuzziness. Copy the list of terms returned in this search. Paste them in the Add Terms box on
the Search Terms Report form. Doing this enhances your search term list, while avoiding errors
caused by special characters.
n Use the dtSearch Dictionary to identify variations of a term instead of using wildcards.
o Identify which terms should be in the highlight set and which terms are not necessary.
o You may want to avoid highlighting terms with high word counts.
User Guide 60
4 Search terms reports
Search terms reports provide the ability to identify documents containing specific keywords or terms. You
can enter multiple terms and generate a report listing the number of hits for each term in a document. You
can also select an option to create a multiple object field for the search terms report to use in your persistent
highlight sets. When you select a search terms report for use with a persistent highlight set, the report
determines which terms or phrases to highlight in the documents through the Review Interface.
n lead
n asbestos
n asphalt
n radioactive isotopes
You save and run the report. The results tell you how prevalent these terms are in the data set.
You now have a better idea of what lies ahead.
n Define a saved search using conditions that return the required group of documents for the Search-
able Set. Persistent highlighting applies only to documents in the searchable set. Relativity also only
counts hits that fall within the searchable set. Related items not included in the searchable set will not
be searched for search terms.
n Confirm that your dtSearch index includes all documents in the Searchable Set of the search terms
report.
User Guide 61
n Select the Tag Hits toggle to create a multiple object field for the search terms report. If this field is
not created you cannot select it in the Highlight Fields option when creating a persistent highlights
set. See Persistent highlight sets.
n When using a search terms report as a highlight source in a persistent highlight set, only the terms in
documents associated with the current reports appear highlighted. If you add new search terms to the
reports, you must run pending terms so that they appear highlighted in documents.
n The system automatically preserves the precise order in which the terms were entered when gen-
erating a report.
Note: Fuzzy searching is not supported in Search Terms Reports (STR). You must use the
Dictionary function to perform fuzzy searching. You would then add the desired terms to the STR.
For information on how to use the Dictionary, see Running a Dictionary search.
4.2.1 Fields
Search terms reports contain the following fields:
User Guide 62
n Name—the search terms reports name. This value cannot exceed 75 characters.
n Index—the dtSearch index used to create the report.
n Searchable set—a saved search that includes a set of documents you want to use for your search
terms reports. The Searchable Set Index field displays the index associated with the saved search
you select. The index for the saved search may differ from the search index used to create the search
User Guide 63
terms report.
n Include relational group—includes the "Documents with Hits + [Group Name]" counts for each term
in the search terms results. This value counts the documents with hits for each term as well as all doc-
uments in the same relational group as the documents with hits. Include relational group only
includes hits of related items in the searchable set. Relativity does not look outside of the searchable
set. Click Select and then choose a relational group to include.
n Tag Hits—if enabled, saves the results to a multiple object field named after the search terms report
with the prefix STR, STR - Industry terms for example, so that the results can be reviewed later. Tags
each document containing search hits using the STR multiple object field with the search terms found
in each document.
n Show in Field Tree—if enabled, automatically adds the terms to the field tree on the Documents
view.
n Calculate unique hits—if enabled, includes a unique hits value for each term in the search terms
results. Unique hits is the count of documents in the searchable set returned by only that particular
term. If more than one term returns a particular document, that document is not counted as a unique
hit. Unique hits reflect the total number of documents returned by a particular term and only that par-
ticular term.
Note: Unique hits can help you identify terms in your search terms report that may be overly
inclusive.
n Remove Hidden Characters—if enabled, automatically filters out hidden or non-displayable text
control characters when creating or editing terms for the Search Terms Reports.
o These hidden control characters have been known to cause issues in searching and can be
unknowingly copied from Word or Excel documents.
o The list of control characters that are filtered are the same as the default ignore section of the
dtSearch alphabet file text.
User Guide 64
n Email notification recipients—specifies recipients to send an email notification to when your
search terms report finishes running. Enter the email addresses of the recipients. Separate entries
with a semicolon.
n Notes—enter notes specific to the search terms report.
When viewing a list of search terms for a search terms report, term strings are limited to a set number of
characters by default. Hover over a term to view the term string in its entirety.
1. From your active workspace, ensure that the Search Terms Reports object type setting for Copy
Instances On Workspace Creation is enabled.
2. Create a new workspace using the active workspace as your workspace template.
The search terms reports are copied over to the new workspace.
User Guide 65
4.2.2 Adding terms and highlight colors
To add terms to your search terms report:
Note: You must create a persistent highlight set for highlighted terms to appear in your documents. See
Persistent highlight sets for more information.
Note: Each line is treated as an individual dtSearch query. For more information about dtSearch,
refer to the Searching Guide .
4. (Optional) Select a background color and text color using the color picker. See the preview text to
verify that the resulting highlighted text is readable. By default, highlighted terms appear as black text
with an orange background.
5. Click Add to add your new terms to the terms list.
A confirmation message displays with the count of new terms added. Duplicate terms are ignored. After
adding new search terms to an existing report, you must run the terms so that they appear highlighted in
documents. For more information, see Running a search terms report.
Note: Changes to background and text color apply to all terms being edited.
User Guide 66
4.2.4 Deleting terms
To remove terms from the search terms report:
1. From the Search Terms Reports tab, click the checkbox next to the search terms report you want to
copy.
2. From the mass operations bar, select Checked. Alternatively, you can select All to copy all search
terms reports.
3. Select Copy in the drop-down menu.
The Copy window displays.
n Run All Terms—generates counts for each term. Use this option when generating the report for the
first time or if you want to regenerate counts for all terms in the report. Run all terms after adding new
documents to the searchable set.
n Run Pending Terms—updates an existing report. It runs a report on only those terms with a Pending
status.
n View Results—opens the Search Terms Results (All) page. This page displays the report results, list-
ing the number of document hits for each term. From the Search Terms Results (All) page, click the
To Report button to return to this page.
User Guide 67
n View Term Report—opens the report in a graphical format. You can print or save the report. To save
the report, click the Export To drop-down menu at the top of the page and select a file type, such as
PDF. The file export begins automatically and saves the file to your local download location.
The Search Terms Reports > Terms table has the following columns:
Note: Documents with hits is not security-aware or influenced by permissions. This means that it
includes documents the user cannot view in a basic search. For example, a user could perform a
dtSearch that returns a total of five documents, including two inaccessible documents. Even
though the user can only view three documents, the search terms count still includes all five
documents originally tagged with the search term.
n Documents with hits, including group—counts the documents with hits for each term as well as all
documents in the same relational group as the documents with hits. The count only includes hits of
related items in the searchable set. It will not look outside of the searchable set.
n Unique hits—counts the number of documents in the searchable set returned by only that particular
term. If more than one term returns a particular document, that document is not counted as a unique
hit. Unique hits reflect the total number of documents returned by a particular term and only that par-
ticular term.
n Last Run Time—time stamp when the search terms report last ran.
n Last Updated—time stamp when the search term was last updated.
n Error messages—displays error messages for report terms, if encountered. See Managing errors
for more details on error handling in search terms reports.
n Text Color—the font color you set when adding the term.
n Background Color—the background color you set when adding the term.
In this page, you can also access a list of any terms that failed during the creation of the search terms report.
To read these error messages, change your view to Search Terms Results (All).
User Guide 68
Note: RelativityOne now runs up to 20 search terms reports in parallel, simultaneously, on a single
instance across any number of workspaces. You can, however, queue as many reports as needed and
they will run when others complete.
This section also provides a summary of the search terms report and its results:
User Guide 69
The error messages tell you the type of error encountered. For example, you can resolve syntax errors
yourself and then retry them, while support errors require customer support for resolution.
n Syntax errors—the search index could not search for the term due to an error in the syntax. The mes-
sage tells you what is wrong with the syntax and how to fix it. You can fix these errors yourself by edit-
ing the term and addressing the issue outlined in the error message. For example, the second syntax
error in the image below indicates a missing parenthesis. You can edit the term and add the missing
parenthesis in this case.
After you address syntax errors, you must rerun the report to capture the terms. Click the Run
Pending Terms button in the Run Report console to run the report on the pending terms. When
complete, the page updates with the new term status.
User Guide 70
n Support errors—are errors that you cannot resolve yourself. Support errors require intervention
from customer support. The error message includes an expandable section with explicit details about
the error, which support can use to help determine and resolve the issue.
User Guide 71
4.5 Using tagged search terms in a saved search
After you run a search terms report with the Tag option enabled, Relativity creates choices for each of the
terms that you specified. You can then use these choices as criteria in a saved search.
Use this procedure to create a saved search using tagged search terms:
1. Follow the instructions for setting fields in the Information and Search Conditions sections on a saved
search.
2. Click on the Fields tab in the Saved Search pop-up.
3. Select the desired field in the Unselected section and move it to the Selected section using the arrow
icons.
4. Click the Condition button and select an option from the pop-op.
User Guide 72
5. Perform the following tasks on the Select STR dialog:
a. Select your search terms report in the Field box.
b. Select an Operator, such as any of these.
c. Select the STR option from the Condition drop-down menu to select search terms on the
Select Items dialog.
d. Set any other fields as necessary.
6. Click OK.
For example, if you added the tagged search terms called money, crime, and oil, the Conditions sec-
tion would appear as follows:
4.6 Permissions
You may have an occasion where you want to grant limited permissions to a group of users outside of the
site administrators. For example, you want to limit users from creating new Search Terms Reports to keep
your environment organized. However, at the same time, you want users to view, edit, and add to existing
terms lists.
To add search terms reports permissions to a user group:
User Guide 73
1. Create a new user group and add it to your workspace.
Note: If you do not know how to create a new user group, see The Admin Guide. If you need help
adding the group to your workspace, see The Admin Guide.
2. From the Manage Workspace Permissions modal window, click Edit Permissions.
In the image below, the group name is Processing - STR Users.
3. Scroll down to locate the two entries for search terms reports—Search Terms Reports and Search
Terms Result. You want to edit permissions for existing terms, so you will edit the Search Terms Res-
ult object. The Search Terms Reports object grants permissions for reports overall and not the con-
tent within the report. Click one or more icons to enable the permission level. Available levels include
Disable, View, Edit, Delete, Add, or Manage Security.
4. Click Save.
5. Click the Manage Workspace Permissions link.
6. Click the Preview button for your group.
The workspace opens with the group permissions applied. This view is helpful if you want to see how
the workspace looks and functions as a group member. A banner across the top of the page reminds
you of the preview mode.
User Guide 74
Note: If the only permission level granted is Edit, you will not see any buttons above the list. In this
case, you can click any search term to enable a text box. Complete your edits and click Enter to
save and exit.
User Guide 75
5 Searching overview
Relativity includes flexible search features designed to facilitate the document review process. These
features support a range of searching needs from filtering on fields and simple keyword searches to the
development of complex queries. The following list summarizes the searching features available in
Relativity.
5.1 Filters
You can use filters to limit the documents or items that appear in item lists on Relativity tabs and pop-ups.
When you enable the filters for an item list, you can set criteria on single or multiple fields so that only
matching documents or items appear in the view.
Filters query across the searchable set of documents in the active view to return your results. Relativity
supports multiple filter types so that you can choose the best format for different field types. See the
Searching Guide for more information.
5.4 dtSearches
Available on the Documents tab, you can use the advanced searching functionality to run queries with
proximity, stemming, and fuzziness operators, along with basic features such as Boolean operators and
wildcards.
System administrators can create a dtSearch index for a specific subset of documents in a workspace, and
then assign security to it. They must manually update indexes when you modify the document search sets
used to create them. See the Searching Guide for more information.
5.5 Analytics
Supporting conceptual searching, Analytics includes documents in a result set when they contain similar
ideas or conceptual relationships, rather than matching specific search terms or conditions.
You can create searches with Analytics that categorize your documents based on the concepts contained in
a sample document set. Instead of categorizing documents, you can also perform clustering, which uses
User Guide 76
specific algorithms, system-defined rules, to identify conceptually related documents. See the Searching
Guide for more information.
With the search condition option, you can build queries using the same condition options available for saved
searches. You can click Save as Search on the Documents tab to create saved searches based on the
criteria defined for keyword searches, dtSearches, Analytics, or the search conditions option. See the
Searching Guide for more information.
You can also use the search bar to view recent searches. Click in the search bar to see up to 10 of the most
recent searches from any index in descending order, with the most recently run search first.
Select any search from the list to run that search. To clear the list, click Clear Recent Searches.
User Guide 77
Note: To use the search conditions option, you must have add or edit permissions for Search and access
to the Saved Searches Browser assigned to you through the Security page. See Workspace security in
the Admin Guide.
User Guide 78
If you need to edit the condition, click on the condition card. The pop-up reopens so you can make changes.
3. Select the desired operator from the Operator drop-down list. For example, these conditions.
4. Click Add Condition.
5. Select the condition from the Add Condition drop-down list. For example, Batch:: Batch Set.
6. Click the available fields from the Available column and move them to the Selected column as
desired.
7. Click Apply.
8. (Optional) Click Add Logic Group to add a logic group. Logic groups are evaluated first and then
connected to other filter conditions or logic groups using AND / OR operators.
9. (Optional) Drag and drop conditions into logic groups as desired.
10. Click Apply on the Condition: Batch window.
Relativity applies your search conditions.
For more information about multiple object searching logic, see Multiple object searching.
Note: Relativity creates an audit record in the History tab for canceled queries. The query description
displays the running time of the query and indicates that it was canceled. You must have the appropriate
permissions to view this tab.
The following table explains different scenarios in which you might cancel a running query and whether the
query actually cancels.
Scenario Result
You start a query and click Cancel Request or Cancel. The query is canceled.
User Guide 79
Scenario Result
You start a query and close the browser. The query is canceled.
You start a query and an system admin resets the IIS on the server. The query is not canceled.
You start a query and leave your browser idle for longer than the ses- The query is not canceled.
sion timeout specified in Relativity web.config, regardless of whether
you clicked OK or Cancel on the message from the webpage pop-
up.
You start a query and click Cancel on the message from the The query is canceled.
webpage pop-up within the session timeout specified in Relativity
web.config.
You start a query and click OK on the message from webpage pop- The query continues to run. Relativ-
up within the session timeout specified in Relativity web.config. ity returns you back to the waiting
screen (see the first row of this
table).
You start a query and paste a different URL into your browser, or you The query is canceled.
refresh the page.
User Guide 80
When you add multiple search conditions to a query, Relativity searches on these conditions relative to
each other, which slows down the return of your results. For example, you experience slow performance
when running a query on all email messages received "after June 1" and "before June 30" of the same year.
You can improve performance by using as few conditions as possible, such as excluding the condition
"before June 30". Run the query with only the condition "after June 1", and then sort or filter your results to
display messages received between the desired dates.
User Guide 81
6 Tabs
A workspace contains tabs that provide you with easy access to different Relativity features, including
documents, search terms reports, views, and other default functionality. Relativity is a highly customizable
platform. Commonly used tabs can be added to the Sidebar so that they can conveniently be accessed at
any time.
Note: RelativityOne includes a tool that allows you to choose a workspace to use as a source template for
tab structure and then lets you apply that template across multiple workspaces in your instance.
You can also apply any workspace template with a tabs arrangement that best serves your review needs.
Some workspace templates also include custom tabs for specialized functionality.
You can add custom tabs in workspaces or at Home. Users with admin rights also have access to a Tabs
tab from Home. The functionality of this Tabs tab is the same as the Tabs tab in a workspace.
In addition, Relativity automatically creates a tab when you add a new object type.
Using tabs
You're a system admin facilitating a document review project involving thousands of patients
whose private personal health information was stolen during a security breach.
You're in the process of creating an application for tracking the many attorneys associated with
this litigation. You want to add to this application a list of all the law firms where these attorneys
work to go along with the list of attorney names you've already created.
To do this, you want to create a new tab to hold the names of these law firms. You go to the Tabs
tab and create a new tab with a name of Law Firms and an order of 10. You keep the Link Type
field at its default value of Object. For the Object Type field, you select the Law Firm object type,
which you just created as one of the several objects that will make up the application you're
creating.
User Guide 82
Once you save the Law Firms tab, you can now populate it with the names of firms that employ
the many attorneys involved in your case.
2. Click New Tab. If you're editing an existing tab, click the icon in the row of the tab you would like
to edit.
3. Complete the fields on the form. See Fields below.
4. Click Save.
6.2 Fields
Information on the fields in the Tab Information and Tab location are described below.
User Guide 83
6.2.1 Tab Information
n Name - the tab’s name. This field must be between 1 and 50 characters. Be as concise as possible
when naming tabs.
n Tab Type - determines the type of tab you want to create:
o Object - creates a tab for a non-document object in your workspace.
o Parent - establishes the tab as a parent tab. Existing tabs can then be set as children of the par-
ent tab, which causes them to display in the Sidebar's fly-out menu or in the Tab strip when the
parent tab is currently selected. Selecting this option changes the layout by hiding the Object
Type and Set as Default fields.
o External - link to any URL or object type in Relativity.
Note: Selecting External from the Link Type menu causes the Link field to appear below
the Parent field. In the Link field, you can enter a web address to link to a URL.
You can create a link from a tab to an Relativity Dynamic Object (RDO) or a script, using either
an Artifact ID or GUID. To create links to other objects, you must use their GUIDs. For
information about working with objects that don't have GUIDs, see Tabs on page 82.
Use the following token to link to an object: ObjectArtifactIdentifier=[identifier], where
[identifier] is the GUID of the object, or in the case of RDOs and scripts, the GUID or Artifact ID.
For example, you would use the format ObjectArtifactIdentifier=736b1c1f-d22f-43cf-9094-
cc8acf94c60 to create a link from a tab to the object with this GUID.
Use the following case insensitive text replacement options to customize the URL, allowing you to
display current details about your workspace:
User Guide 84
Text Replacement Option Replacement Text
%ApplicationPath% The actual application path
%ArtifactTypeID% ArtifactTypeID=<Current ArtifactTypeID>
%AssociatedArtifactID% AssociatedArtifactID=<Current Instance Artifact ID>
%AuthenticationToken% AuthenticationToken=<New Authentication Token>
%ConnectorfieldArtifactID% ConnectorFieldArtifactID=<Current Connector Field Artifact ID>
%ParentArtifactID% ParentArtifactID=<Current Parent ArtifactID>
%SystemID% SystemID=<Current System ID>
%SelectedSearchArtifactID% SelectedSearchArtifactID =<Current Search Artifact ID>
n Object Type - determines which object’s information is displayed in the tab for those specified as
Link Type = Object.
n Set as Default Tab - toggle on to make this tab serve as the workspace’s default tab. Reviewers log-
ging in to the workspace are taken to the default tab. If a reviewer does not have access to the default
tab, he or she is directed to the Documents tab instead.
n Visible - toggle on to display this tab from the Sidebar, Tab strip, and/or Quick nav.
n
Relativity Applications - add this tab to a Relativity application. Clicking brings up a list of
available applications.
n Show in Sidebar - toggle on to add this tab to the Sidebar. Depending on the number of tabs that
have already been added to the Sidebar, the Order value assigned to this tab, and your browser's res-
olution, the tab may be displayed in the More menu if it does not fit into the current Sidebar.
n Parent - select a parent tab to assign the current tab as a child tab. The current tab will display in the
fly-out menu for the parent tab.
n Order - represents the position of the tab by a numerical value. It can be any positive or negative
integer. You cannot use decimals in this field. The lowest-numbered tab displays at the top of the
User Guide 85
Sidebar. The highest-numbered tab displays at the bottom of the Sidebar or in the More menu. Items
that share the same value are sorted in alphanumeric order.
Note: It’s always a good idea to set tab order by 10's, starting with 10, then 20, then 30, etc. By
numbering in groups of 10 you can insert an item into any position later in the workspace, without
the need to reorder (for example, you can use 10, 20, 25, 30, 40 to insert a new tab between 20 and
30).
1. Create a new tab with a Tab Type of Parent or edit an existing tab.
User Guide 86
7 Viewer
The Review Interface displays workspace documents. You can use the Viewer type tabs to toggle the
loaded formats of documents, such as Native Viewer, Image Viewer, Extracted Text Viewer, or Productions
Viewer. Using the Viewer, you can control the form of document that displays in the interface. If a document
has not been imaged, you can image documents on-the-fly in the Viewer.
Note: Using your internet browser to zoom to any size other than 100% while using the Viewer is not
supported and can cause unexpected behavior.
If you do not see the document in the Viewer, it either has not been loaded to the workspace, its conversion
failed, or you do not have permission to see it.
User Guide 87
Note: In the Native Viewer, you can expand the email header to display full email addresses. If you
collapse or expand an email header, the Viewer maintains the expanded or collapsed state as you
navigate through documents in the set.
User Guide 88
7.1 Native Viewer
The Native Viewer displays an HTML rendering of the document that is as close to the original version of the
document as possible. With the Native Viewer, you can:
Note: The Viewer displays PDF text by mapping the character codes to Unicode in most cases. To check
whether PDF text has been properly encoded and will display correctly in the Viewer, copy the text in the
original PDF file and paste it into another application like Microsoft Word or Notepad. If the pasted text
does not display correctly, the PDF is not properly encoded. If the pasted text displays correctly in another
application but not in the Viewer, contact Support for assistance.
User Guide 89
3. Document actions menu
4. Viewer settings menu
5. Viewer breadcrumbs
6. Right drawer Viewer options
Each of these options and menus is described in more detail in the sections below.
n
Zoom Out/In —zooms out and in on the current document in increments of 10% within
a range of 10% to 4,000%. If you attempt to zoom out to a percentage lower than 10%, the Viewer
automatically sets the display to 10%. If you attempt to zoom in to a percentage higher than 4,000%,
the Viewer automatically sets the display to 4,000%. Your zoom setting persists as you navigate
through a document set. This means that if you have set one document to 150% and you go to the
next document, the next document defaults to 150% zoom.
To specify a zoom percentage without using the zoom out/in toolbar buttons, type the number in the
percentage field and press the Enter key.
n
Reset Zoom —resets the zoom to 100%.
n
Fit Width —increases the size of the document to fit the maximum width of the Viewer. This set-
ting persists when you re-size the window.
n
Fit Page —fits the entire document into the total size of the page. Clicking this zooms out the doc-
ument and reduces the font size.
n
Fit Actual - fits the document display to the actual size it was in its native application. By default,
this resets the zoom percentage to 100%.
n
Layout Mode —select one of the following options to determine how documents that are more
than one page long display in the Viewer.
o
Single —one page of a document will display at a time. Use the page navigation options at
the bottom of the Viewer to adjust which page you view.
o
Single Continuous —displays the pages in the document stacked vertically so you can
scroll up and down to view them.
o
Facing Continuous —displays the pages in the document in a row horizontally so you can
scroll left and right to view them.
User Guide 90
n
Draft Mode —click to begin Draft Mode which automatically contrasts text from the background,
help you identify poorly drawn redactions, and identify corrupt OCR text. This option is only available
on the Native Viewer and PDF Viewer with rendered documents.
n
Go To Next/Previous Highlight —moves through previous and next highlighted terms in the
document.
n
Rotate All Pages —rotates all pages in a document clockwise 90 degrees. This option is only
available for documents that have been paginated.
n
Redact Markup Visibility - this option determines how markups display in the Viewer.
It only displays if you have the Redact application installed and open a PDF or spreadsheet document
in the Native Viewer.
Click the Redact Markup Visibility icon to toggle between the following modes:
o Solid - Markups in the document are fully visible and cover text underneath.
o Transparent - Markups in the document are partially visible so that you can still see the text
underneath.
o Hidden - Markups in the document are not visible.
n
Create PDF —click to save the current native document as a PDF file. When you click this option,
the Create PDF pop-up displays. The document then opens in a new window in your browser as a
PDF where you can then choose to save or print the document image.
User Guide 91
Image Format Redactions Highlights File Size Reduction
TIFF Yes No Up to 76%
TIFF Yes Yes Up to 43%
JPEG Yes No Up to 43%
JPEG Yes Yes Up to 43%
After you click Create PDF, a copy of the document converts to a PDF file you can save from your
web browser downloads. Relativity assigns a GUID for Create PDF file names.
n
Search Bar —searches for terms in the current document and nav-
igates through the hits.
o Entering a term and either clicking the left or right arrow button or pressing Enter in this text
box scrolls to and highlights the text of the next instance of the term, from the placement of the
cursor.
o Searching in this text box is not case sensitive.
o Searching supports dtSearch and so proximity, fuzziness, and stemming can be used.
o You can remove a term you previously searched for or all of the terms you have recently
searched for from the Persistent Highlight Pane. Removing a term or terms will also remove
any highlights they generated in the document. To remove a term or terms, hover your cursor
over the row of the term or recent searches you wish to remove and then click on on the
right side of the row.
n
Show/Hide Hidden Cells —displays or hides all hidden cells in a Microsoft Excel spreadsheet.
This functionality is only available for Excel files and does not work on imaged documents because
Relativity only images unhidden cells.
n Persistent Highlighting—displays or hides a panel containing all recent searches from the criteria
entered in the Search Bar and any persistent highlight sets in the workspace. Only terms in the sets
and recent searches that are in the current document will display in the pane.
Additionally, you can control which highlights display in the current document by clicking on either the
persistent set to only display highlights from that set or you can click on a specific term to only see
that term highlighted in the document.
User Guide 92
n Thumbnail—click to expand the left drawer and display the Thumbnail Viewer. Each page of the doc-
ument you are reviewing has its own numbered thumbnail in the Thumbnail Viewer.
n Sentiment—click to expand or collapse the left drawer and display sentiment analysis highlights in
the Viewer.
n Hidden Content—displays or hides all hidden cells in a Microsoft Excel spreadsheet. This
functionality is only available for Excel files and does not work on imaged documents because
Relativity only images unhidden cells.
n Contextual Search—click to expand the right drawer and display the Contextual Search card. This
feature allows you to quickly navigate to matching search terms in a document which is useful in
longer documents or ones that have many matching search terms. The Contextual Search card has
the same functionality as the Search Bar. To learn more about the Search Bar's functionality, see
Search Bar. Additionally, each search term match is displayed in a box that includes both words
before and after the search term match to make it easy for you to view the context of each one.
Enter a term or terms in the search box and press Enter on your keyboard to highlight in yellow any
matches in the current document. You can click on a desired search term box in the pane to jump to
that place in the document. The active search term box will display with a blue border and the
matching search term in the document will be highlighted in blue to make it easy to find.
User Guide 93
7.1.1.5 Document actions menu
Additionally, to exit the Viewer and return to the page you were previously on, you can click the Exit viewer
button at any time.
User Guide 94
7.1.2 Copying text in the Viewer
While viewing a document in the Native Viewer, you have several right-click options, including the Copy
option. Use this option to copy text from the document you are currently viewing and then paste it into
another application.
To do this:
Note: If you don't have permission to the Local Access option on the Document object, you can't use the
Ctrl+C or Ctrl+Ins options in either the Native Viewer or the Extracted Text Viewer.
Note: If an audio or video file has not been opened in the Native Viewer, it may display with a value of No
for the Supported by Viewer field. Once a file has been successfully opened by the Viewer, the Supported
By Viewer field displays Yes.
User Guide 95
The audio and video controls that display in the Viewer depend on your internet browser.
User Guide 96
7.1.4 Document Intelligence
Document Intelligence notifies you that there is hidden or annotated content, including a pivot table or a
filtered pivot table, present in the current document in the Native Viewer. This hidden content are the
annotations and modifications tracked in certain document formats. For more information on the file types,
see Tracking annotations. When hidden content is found in a document, a pop-up modal appears in the
lower-right corner. Highlighting and bordering is also visible in the Viewer where the changes were made
and a annotation bar is available to sort and view each annotation. Once the notifications appear, you can
then choose whether or not to view tracked changes, hidden text and comments in the Viewer.
File exten-
File type Annotation type Tracked changes
sions
Excel .xls, .xlsx, Tracked Changes, formulas, hidden Inserted cell, moved cell,
.xlsb pages/columns/rows, Comments modified cell, cleared cell
Inserted column, deleted
User Guide 97
File exten-
File type Annotation type Tracked changes
sions
column
Inserted row, deleted row
Inserted sheet, renamed sheet
Word .doc, .docx Tracked Changes, comments, hidden text Insertions, deletions, moves
PowerPoint .ppt, .pptx Speaker notes, comments, hidden slides
PDF .pdf Comments
A hidden content icon is available when a supported file type is in the Native Viewer. Click the Hidden
Content icon to open or close the annotations bar. If you are viewing an unsupported file type, the icon is
not available. For supported file types, see the Tracking annotations.
Annotation bar
The annotation bar is for sorting and viewing the hidden content found with Document Intelligence. Each
annotation has a card that lists the tracked change, a description of the change, time and date, and author of
the change.
If there are multiple annotation cards in the annotation bar, then you can sort them in multiple ways. Click
the Sort By drop down menu for these options:
n Location
n Author A-Z
n Author Z-A
n Oldest first
n Newest first
n Annotation type
User Guide 98
Annotation types and highlights
Each type of annotation comes with its distinct highlight in the Native Viewer. Below is a table that lists each
annotation type with its highlight in the Viewer:
Leader lines
Clicking on an annotation in the Viewer connects the selected annotation to the related annotation tile in the
annotation bar. Click on another annotation to view the leader line to that annotation card. One grey
connector line is available at a time, unless you moved a cell. In this case, there is a leader line where the
cell was originally located and a leader line in the cell's new location. Click the same annotation to remove
the leader line.
User Guide 99
Note: The Has Hidden Data field is populated during Processing. The hidden content that the Viewer
finds may not be perfectly in-sync with the hidden data that the Processing engine finds.
Note: If you used the Basic Imaging profile to produce images of a PDF file, please note that the Viewer
displays PDF text by mapping the character codes to Unicode in most cases. To check whether PDF text
has been properly encoded and will display correctly in the Viewer, copy the text in the original PDF file
and paste it into another application like Microsoft Word or Notepad. If the pasted text does not display
correctly, the PDF is not properly encoded. If the pasted text displays correctly in another application but
not in the Viewer, contact Support for assistance.
n
Zoom Out/In —zooms out and in on the current document in increments of 10%
within a range of 10% to 4,000%. If you attempt to zoom out to a percentage lower than 10%, the
Viewer automatically sets the display to 10%. If you attempt to zoom in to a percentage higher than
4,000%, the Viewer automatically sets the display to 4,000%. Your zoom setting persists as you nav-
igate through a document set. This means that if you have set one document to 150% and you go to
the next document, the next document defaults to 150% zoom.
To specify a zoom percentage without using the zoom out/in toolbar buttons, type the number in the
percentage field and press the Enter key.
n
Reset Zoom —resets the zoom to 100%.
n
Fit Page —fits the entire document into the total size of the page. Clicking this zooms out the doc-
ument and reduces the font size.
n
Fit Actual —fits the document display to the actual size it was in its native application. By default,
this resets the zoom percentage to 100%.
n
Layout Mode —select one of the following options to determine how documents that are more
than one page long display in the Viewer.
o
Single —one page of a document will display at a time. Use the page navigation options at
the bottom of the Viewer to adjust which page you view.
o
Single Continuous —displays the pages in the document stacked vertically so you can
scroll up and down to view them.
o
Facing Continuous —displays the pages in the document in a row horizontally so you can
scroll left and right to view them.
n
Rotate all pages —rotates all pages in a document clockwise 90 degrees.
n
Rotate current page —rotates only the current page clockwise 90 degrees.
Note: Image rotation is persistent. Any pages that you rotate will be rotated the next time you
return to them in the Viewer and for other users who view them after you rotate them. Rotation is
also applied when you run the production containing the images.
n
Selector —select within a document.
n
Markup Visibility —changes the visibility mode of the markups between full visibility, transparent
and hidden. By default, this is set to Solid, which means all highlights and redactions appear as solid
as you applied them.
n
Highlight - <Color> —highlights the selected text with the color you specify from the drop-
down menu. The default color is blue. Select from the following:
o Blue
o Green
o Orange
o Pink
o Purple
o Yellow
n
Redaction Mode - Full page —enables the full-page redaction tool. The drop-down menu for
this redaction type offers the same options as the basic Redact icon, except that the redaction you
choose is applied to the entire page. For example, if you select White, the entire page becomes
white. For more information, see Creating full-page redactions on page 31.
n
Redaction Mode - Inverse —enables the inverse redaction tool. For more information, see Creat-
ing inverse redactions on page 30.
n
Redaction Mode - Mass Redact —apply a full-page redaction across all images or a range of
images in the document. For more information, see Creating mass redactions on page 31.
n
Redaction Type - <Style> —enables single redaction tool. For more information on redacting,
see Creating basic redactions on page 29. Select from the following types of redactions:
o
Black —applies a solid black box to the selected text.
o
Cross —applies a white box with an X in the middle of it over the selected text.
o
Text —applies a box over the selected text, in which you can add text such as "Privileged"
or "Redacted."
o
White —applies a solid white box over the selected text.
n
Font Size —change the font size of the text within a text box redaction.
n
Delete Highlights —mass delete markups from any or all images in the document. For more
information, see Mass deleting markups on page 36.
n
Create PDF —gives you the option of saving the image as a PDF. For more information, see Sav-
ing an image as a PDF.
Clicking the icon brings up the following window, in which you can specify your PDF settings:
n PDF Profile—select the desired PDF profile to determine how the PDF will be customized.
n Page Range—select from the following standard print range options:
o All pages—saves all pages in the document.
o Current Page—saves only the page you are currently on.
o Pages—saves a range of pages that you specify in the text box to the right.
n
Reset Zoom —resets the zoom to 100%.
n
Go To Next/Previous Highlight —moves through previous and next highlighted terms in the
document.
n
Tab character size —select an option from the drop-down menu to determine the
amount of space that is taken when the Tab key was used in the current document. This option can
help you ensure that the spacing in a spreadsheet document is aligned and works best when the Tab
key is used after each column in the spreadsheet.
n
Toggle WordWrap —determines whether the text in the current document will wrap so that it fits
on the current page or not.
o Enabled—text in the current document will be forced onto the next line if it cannot display in
the current window size. You cannot scroll horizontally with Toggle WordWrap enabled.
o Disabled—text in the current document will not be forced onto the next line will display in more
horizontal fashion. You can scroll horizontally to control to view the desired text.
n
Search Bar —searches for terms in the current document and navigates
through the hits.
o Entering a term and either clicking the left or right arrow button or pressing Enter in this text
box scrolls to and highlights the text of the next instance of the term, from the placement of the
cursor.
o Searching in this text box is not case sensitive.
o Searching supports dtSearch and so proximity, fuzziness, and stemming can be used.
Note: If you don't have permission to the Local Access option on the Document object, you can't use the
Ctrl+C or Ctrl+Ins options in either the Native Viewer or the Extracted Text Viewer.
n Sentiment—click to expand or collapse the left drawer and display sentiment analysis highlights in
the Viewer.
n Contextual Search—click to expand the right drawer and display the Contextual Search card. This
feature allows you to quickly navigate to matching search terms in a document which is useful in
longer documents or ones that have many matching search terms. The Contextual Search card has
the same functionality as the Search Bar. To learn more about the Search Bar's functionality, see
Search Bar. Additionally, each search term match is displayed in a box that includes both words
before and after the search term match to make it easy for you to view the context of each one.
Enter a term or terms in the search box and press Enter on your keyboard to highlight in yellow any
matches in the current document. You can click on a desired search term box in the pane to jump to
that place in the document. The active search term box will display with a blue border and the
matching search term in the document will be highlighted in blue to make it easy to find.
Additionally, to exit the Viewer and return to the page you were previously on, you can click the Exit viewer
button at any time.
Note: The redactions that are burned into a produced image are the redactions that were on the image at
the time that you produced it. If you add or remove redactions from an image after you've produced it,
then the image and the produced version of that image will be out of sync.
Select a production set from the drop-down menu to see how a document was produced in the selected
production. If a document is not included in a production, the productions mode option is unavailable.
n
Create PDF —gives you the option of saving the image as a PDF. For more information, see Sav-
ing an image as a PDF.
n
Zoom Out/In —zooms out and in on the current document in increments of 10%
within a range of 10% to 4,000%. If you attempt to zoom out to a percentage lower than 10%, the
Viewer automatically sets the display to 10%. If you attempt to zoom in to a percentage higher than
4,000%, the Viewer automatically sets the display to 4,000%. Your zoom setting persists as you nav-
igate through a document set. This means that if you have set one document to 150% and you go to
the next document, the next document defaults to 150% zoom.
To specify a zoom percentage without using the zoom out/in toolbar buttons, type the number in the
percentage field and press the Enter key.
n
Reset Zoom —resets the zoom to 100%.
n
Fit Width —increases the size of the document to fit the maximum width of the Viewer. This set-
ting persists when you re-size the window.
n
Fit Page —fits the entire document into the total size of the page. Clicking this zooms out the doc-
ument and reduces the font size.
n
Fit Actual —fits the document display to the actual size it was in its native application. By default,
this resets the zoom percentage to 100%.
n
Layout Mode —select one of the following options to determine how documents that are more
than one page long display in the Viewer.
o
Single —one page of a document will display at a time. Use the page navigation options at
the bottom of the Viewer to adjust which page you view.
o
Single Continuous —displays the pages in the document stacked vertically so you can
scroll up and down to view them.
o
Facing Continuous —displays the pages in the document in a row horizontally so you can
scroll left and right to view them.
n
Rotate all pages —rotates all pages in a document clockwise 90 degrees.
Note: Image rotation is persistent. Any pages that you rotate will be rotated the next time you
return to them in the Viewer and for other users who view them after you rotate them. Rotation is
also applied when you run the production containing the images.
n Thumbnail—click to expand the left drawer and display the Thumbnail Viewer. Each page of the doc-
ument you are reviewing has its own numbered thumbnail in the Thumbnail Viewer. To learn more,
visit Thumbnail Viewer.
n Download—hover your cursor over this option and select one of the following:
o Active production—select to download a copy of the produced document. A user must be
granted the Documents - Local Access (Download, Copy Text) permission to use this option.
Note: This option is not currently available to RelativityOne Government users because it is
part of the facade redactions update.
o Document native—select to download a copy of the current document. A user must be gran-
ted the Documents - Local Access (Download, Copy Text) permission to use this option.
If you cannot download a copy of the document, this option is grayed out. Hover your cursor
over this option to view a tooltip that contains an explanation why this option is disabled.
A system or case administrator can determine which native file types users can and cannot
download by doing the following:
o Navigate to the Native Types tab.
o Click the Edit icon in the row of the desired file type.
n Copy document link—select to copy the URL to the current document to your clipboard.
n Email document—select to open an email in your default email application with the URL to the cur-
rent document included in the body of the email. The subject of the email will include the name of the
workspace and the current document.
n Replace document native—select to replace the native file of the current document with a new file.
n Image on the fly/Delete all images for this document—Image on the fly will display if the current
document has not been imaged. If the current document has been imaged, delete all images for this
document will display instead.
o Delete all images for this document—select to delete all images associated with the current
document.
o Image on the fly—to image the current document from the Viewer, hover your cursor over this
option and the Image Profile options will display. Select the desired profile option to begin the
imaging process.
A system or case administrator can determine which native file types can or cannot be imaged
using Image on the fly by doing the following:
o Navigate to the Native Types tab.
o Click the Edit icon in the row of the desired file type.
o On the Restricted From Imaging By Default field, select Yes to prevent users from
using this option to image the native type or No to allow users to image the native file
n Replace images for this document—to replace the images for the current document using an ima-
ging profile, hover your cursor over this option and select the desired Imaging Profile option to begin
the imaging process.
n Reconvert—select to clear your internet browser's cache and reload the current document for
review.
Additionally, to exit the Viewer and return to the page you were previously on, you can click the Exit viewer
button at any time.
Note: If the source file of the document you are imaging is changed during the conversion process, for
example through overlay, that document becomes undeliverable and you receive an error. To resolve this
error, refresh the page or re-image the document.
After imaging a document on the fly, you can access thumbnail renderings of the imaged pages of the
document.
Imaging some file formats can cause problems. Consider the following:
n Many PDFs render and image very well. However, you may have problems rendering and imaging
some PDFs due to the variety of their content.
n While most Microsoft Office documents render and image well, you may experience issues when ima-
ging documents with embedded files.
n You may have problems rendering and imaging vector-based documents like Visio and CAD.
Notes: You may experience slowness if you try to open PDF documents that are larger than 300 mega-
bytes.
The Viewer displays PDF text by mapping the character codes to Unicode in most cases. To check
whether PDF text has been properly encoded and will display correctly in the Viewer, copy the text in the
original PDF file and paste it into another application like Microsoft Word or Notepad. If the pasted text
does not display correctly, the PDF is not properly encoded. If the pasted text displays correctly in another
application but not in the Viewer, contact Support for assistance.
There are options available in the following sections of the Viewer:
n
Zoom Out/In —zooms out and in on the current document in increments of 10% within
a range of 10% to 4,000%. If you attempt to zoom out to a percentage lower than 10%, the Viewer
automatically sets the display to 10%. If you attempt to zoom in to a percentage higher than 4,000%,
the Viewer automatically sets the display to 4,000%. Your zoom setting persists as you navigate
through a document set. This means that if you have set one document to 150% and you go to the
next document, the next document defaults to 150% zoom.
To specify a zoom percentage without using the zoom out/in toolbar buttons, type the number in the
percentage field and press the Enter key.
n
Fit Width —increases the size of the document to fit the maximum width of the Viewer. This set-
ting persists when you re-size the window.
n
Fit Page —fits the entire document into the total size of the page. Clicking this zooms out the doc-
ument and reduces the font size.
n
Fit Actual - fits the document display to the actual size it was in its native application. By default,
this resets the zoom percentage to 100%.
n
Layout Mode —select one of the following options to determine how documents that are more
than one page long display in the Viewer.
o
Single —one page of a document will display at a time. Use the page navigation options at
the bottom of the Viewer to adjust which page you view.
o
Single Continuous —displays the pages in the document stacked vertically so you can
scroll up and down to view them.
o
Facing Continuous —displays the pages in the document in a row horizontally so you can
scroll left and right to view them.
n
Draft Mode —click to begin Draft Mode which automatically contrasts text from the background,
help you identify poorly drawn redactions, and identify corrupt OCR text. This option is only available
on the Native Viewer and PDF Viewer with rendered documents.
n
Go To Next/Previous Highlight —moves through previous and next highlighted terms in the
document.
n
Redact Markup Visibility - this option determines how markups display in the PDF Viewer.
Click the Redact Markup Visibility icon to toggle between the following modes:
o Solid - Markups in the document are fully visible and cover text underneath.
o Transparent - Markups in the document are partially visible so that you can still see the text
underneath.
o Hidden - Markups in the document are not visible.
n Thumbnail—click to expand the left drawer and display the Thumbnail Viewer. Each page of the doc-
ument you are reviewing has its own numbered thumbnail in the Thumbnail Viewer.
n Sentiment—click to expand or collapse the left drawer and display Sentiment Analysis Highlights in
the Viewer.
n Hidden Content —displays or hides all hidden cells in a Microsoft Excel spreadsheet. This
functionality is only available for Excel files and does not work on imaged documents because
Relativity only images unhidden cells.
n Contextual Search—click to expand the right drawer and display the Contextual Search card. This
feature allows you to quickly navigate to matching search terms in a document which is useful in
longer documents or ones that have many matching search terms. The Contextual Search card has
the same functionality as the Search Bar. To learn more about the Search Bar's functionality, see
Search Bar. Additionally, each search term match is displayed in a box that includes both words
before and after the search term match to make it easy for you to view the context of each one.
Enter a term or terms in the search box and press Enter on your keyboard to highlight in yellow any
n Download document native—select to download a copy of the current document. A user must be
granted the Documents - Local Access (Download, Copy Text) permission to use this option.
If you cannot download a copy of the document, this option is grayed out. Hover your cursor over this
option to view a tooltip that contains an explanation why this option is disabled.
A system or case administrator can determine which native file types users can and cannot download
by doing the following:
n Navigate to the Native Types tab.
n Click the Edit icon in the row of the desired file type.
n Copy document link—select to copy the URL to the current document to your clipboard.
n Email document—select to open an email in your default email application with the URL to the cur-
rent document included in the body of the email. The subject of the email will include the name of the
workspace and the current document.
n Replace document native—select to replace the native file of the current document with a new file.
n Image on the fly/Delete all images for this document—Image on the fly will display if the current
document has not been imaged. If the current document has been imaged, delete all images for this
document will display instead.
o Delete all images for this document—select to delete all images associated with the current
document.
o Image on the fly—to image the current document from the Viewer, hover your cursor over this
option and the Image Profile options will display. Select the desired profile option to begin the
imaging process.
A system or case administrator can determine which native file types can or cannot be imaged
using Image on the fly by doing the following:
o Navigate to the Native Types tab.
o Click the Edit icon in the row of the desired file type.
o On the Restricted From Imaging By Default field, select Yes to prevent users from
using this option to image the native type or No to allow users to image the native file
n Replace images for this document—to replace the images for the current document using an ima-
ging profile, hover your cursor over this option and select the desired Imaging Profile option to begin
the imaging process.
n Reconvert—select to clear your internet browser's cache and reload the current document for
review.
n Keyboard Shortcut Legend—select to open the Keyboard Shortcut Legend pop-up modal to view
the current keyboard shortcuts available in the Viewer.
n Enable/Disable Keyboard Shortcuts—select to enable or disable the keyboard shortcuts feature
while in the Viewer.
n Show/Hide Tab Strip—select to show or hide the sidebar and tab strip in the Native Viewer.
n Pop Out Viewer—select to open the Viewer in a new window in your browser. To learn more, visit
Pop Out Viewer.
n Swap Layout—select to move the coding layout and the document card to the opposite side of the
Viewer from where they are currently located.
Alternatively, if you close the browser window that the popped out Viewer is in, the Viewer pops in to the
Review Interface or in other words, returns to the original browser window.
n
Document history —displays a history of actions taken on the current document. You may not
have access to document history. If you store your audits in Data Grid, this displays the field name,
old value, and new value.
Note: In the Document History card, you can click the Details link to display a pop-up with the audit
history for the document. Click Run Details to display information about document imaging jobs,
including the name of the imaging profile and the formatting options used during mass imaging or
imaging on the fly.
n
Search results —displays the results of an Analytics search.
n
Batch sets —shows all the batch sets for the active record. See Batches in the Admin manual.
You may not have permissions to view this section.
When a coding decision is made, the information in the Related Items card automatically refreshes. If there
are two or more reviewers on the same document, a user can refresh this card by clicking on the Menu icon
and selecting Refresh card.
The Related items card can be opened in a separate browser window. Click the Menu icon and select Pop
out card to open the card in its own window. Click the Menu icon and select Pop in card to close the
browser window and return the card to the Viewer.
2. Click by the With field to select a document with which to compare it. A Select Item pop-up
window displays.
Note: You can change the value of either of the fields at any time while in the Document Compare
window.
3. Select the desired document from the list and click Set. The Document Compare window displays the
selected document in the With field.
4. Click Compare. The window displays the similarities and differences between the documents.
5. The similarities and differences between the documents are reflected in the legend at the bottom of
the window:
n Inserted - text appears in the "With" document but doesn't appear in the "Compare" document.
n Deleted - text appears in the "Compare" document but doesn't appear in the "With" document.
n Unchanged -text appears in both documents.
Note: Relativity does not support any third-party applications after the user downloads a file. This
includes specific browser and media-player combinations, such as Internet Explorer and Windows Media
Player.
File Exten-
Program/File Type Category Type/Version
sion
Microsoft Access Report Snapshot Database 2000-2003
IBM Lotus Notes NSF Email 7.x, 8.x
DICOM Multimedia
Flash Multimedia 9, 10
Real Media Multimedia
MPEG-1 Video V 2 Multimedia .mpg
MPEG-1 Video V 3 Multimedia .mpg
MPEG-2 Audio Multimedia .mpg
Windows Media Playlist Multimedia
AOL Messenger Other
Microsoft InfoPath Other 2007
Microsoft Office Theme files Other 2007-2013
Microsoft Windows Compiled Help Other .chm
Microsoft Windows Explorer Command Other .scf
Microsoft Windows Help Other .hlp
Microsoft Windows Shortcut Other .ink
File Exten-
Program/File Type Category Type/Version
sion
7z Archive .7z
Note: BZIP2 and split archives are not supported.
7z Self Extracting exe Archive .exe
Note: BZIP2 and split archives are not supported.
LiveNote Evidence File Archive .lef
LZA Self Extracting Compress Archive .lza
LZH Compress Archive .lzh
Microsoft Office Binder Archive 95, 97 .obd
Microsoft Cabinet (CAB) Archive .cab
PKZip Archive .zip
RAR Archive 1.5, 2.0, 2.9 .rar
TextMap Evidence File Archive .xmef
UNIX Compress Archive .z
UNIX GZip Archive .gz
UNIX tar Archive .tar
Uuencode Archive .uue
Zip Archive PKZip, WinZip .zip
DataEase Database 4.x .dba
DBase Database III, IV, V .dbf
First Choice DB Database Through 3.0 .fol
Framework DB Database 3.0
Microsoft Access Database 2007/2010 .accdb
Microsoft Works DB for DOS Database 2.0 .wdb
Microsoft Works DB for Macintosh Database 2.0 .wdb
Microsoft Works DB for Windows Database 3.0, 4.0 .wdb
Microsoft Works DB for DOS Database 1.0 .wdb
Paradox for DOS Database 2.0 - 4.0 .db
Paradox for Windows Database 1.0 .db
Q&A Database Database Through 2.0 .db
IBM Lotus Notes Domino XML Language DXL Email 8.5 .xml
IBM Lotus Notes NSF (Win32, Win64, Linux x86-32 Email 8.x .nsf. .ntf
and Oracle Solaris 32-bit only with Notes Client or
Domino Server)
MBOX Mailbox Email RFC 822 .mbox
Note: Program/file types listed with text only or PDF preview only can be reviewed in the Viewer as listed.
If PDF preview only, a PDF file saved as part of the native will be viewed. Text only will just display the text
without any formatting.
Note: Relativity does not support any third-party applications after the user downloads a file. This
includes specific browser and media-player combinations, such as Internet Explorer and Windows Media
Player.
To resolve the error, ensure that your internet browser can play the selected file type. If that does not
resolve the error, check the MaximumNativeSizeForViewerForMediaFilesinMegaBytes instance setting
to ensure that the file type is not too big for the Viewer to stream.
Note: Migrating a workspace to cold storage is immediate and will not affect any potential client
related due date charges.
1. The Storage Status column on the workspace view displays the status of the workspace as Cold Stor-
age.
4. Click Retrieve Workspace to retrieve the workspace from cold storage. The Cold Storage Retrieval
Notes:
n Workspace retrievals are not instantaneous, after clicking Retrieve Workspace, it could take
between 24 hours and 5 days to resume operations in that workspace.
n The user who sent the retrieval request will receive an email notification once the retrieval of the
workspace is complete.
n Cold Storage Case Retrieval Agent needs to be present and running for workspaces to be
retrieved from cold storage.
n Migration and retrieval actions are audited.
n You can archive workspaces in cold storage directly using ARM without having to be moved to an
active state before archiving. See the ARM content on the RelativityOne documentation site for more
information.
Note: You can only designate one group per workspace as a workspace admin group.
n Folders
n Field Tree
n Saved Searches
No matter which of these options you use, there are several display options you can use to customize your
workspace.
The Browsers panel opens by default. Hide or expand the Browsers panel by clicking the carrot to the left of
Browsers. If both the Browsers and Search Conditions panels are hidden, click on the Browsers icon to
display it. You can also re-size the Browsers panel by hovering over the line separating the panel from the
other panel or document list until the line is highlighted. You may then click-and-drag the line to the desired
dimensions.
Field Tree Browse your documents according to how they were coded or grouped.
Saved Create a new search, or browse previously saved searches.See Saved Search in
Searches the Searching Guide.
Folders
Click on the Folders icon to navigate the folder hierarchy for your workspace. The folder structure is set
when documents are imported. It can be based on the document’s source, or according to a folder structure
set by your Relativity administrator. Clicking on a folder displays that folder’s documents in the document
list.
Note: To ensure stable performance, we recommend creating no more than 250,000 folders in a
workspace and having 15 sub-folders or less within each folder.
A folder often has multiple sub-folders. Click on the folder to view the sub-folders. Click on the arrow next to
the folder to hide the sub-folders.
To change the folder scope, click on the This folder and subfolders or Only this folder icon.
Each single and multiple-choice field has its own choice folder in the field tree. The field’s choices appear as
sub-folders. Each field also has a [Not Set] choice, which displays null values for the field.
The subject line of the email pre-populates with the following text: Relativity Review - <Workspace Name> -
<Choice Name: Value>. If you send an email link to a choice folder, the subject line displays the folder name
instead of choice name and value.
When the recipient clicks on the link, the documents associated with the choice or folder appear in the
document list. If the recipient does not have required permissions for the choice folder or field associated
with the choice, a permissions denied message displays instead.
Alternatively, you can select Copy Link to Clipboard to copy a link to a view that contains the choice, a
choice folder, or the document list that appears when the field tree is open.
n New documents—click to upload new documents using Simple File Upload. If the Transcripts applic-
ation is installed in this workspace, this icon is replaced with a drop-down menu that allows you to
choose between uploading a new document or a new transcript.
True. The Show Document Preview Panel icon will then display in the upper-right. Additionally, users
must have the Document Preview permission in Other Settings assigned to use this feature.
Note: The Document Preview panel does not support viewing hidden content, creating or modifying
markups, or editing coding decisions. Open the document in the Viewer instead to perform these tasks.
n Persistent Highlighting—displays or hides a panel containing any persistent highlight sets in the
workspace. Only terms that are in the current document will display in the pane. Additionally, you can
control which highlights display in the current document by clicking on either the persistent set to only
display highlights from that set or you can click on a specific term to only see that term highlighted in
the document.
n Markup set—displays the active markup set in a drop-down menu. Choose a markup set from the
drop-down menu to make a different set active. This menu only appears when viewing a document in
the Image Viewer of the Document Preview panel.
n Page navigator—use any of the following options to help you navigate the pages in the document
you are previewing:
Option Description
Reset column Click the blue Reset column sizes icon to return to the original settings for the
columns.
sizes
Turn Grid style Click the blue grid icon to turn grid style on. This shrinks the row padding and altern-
ates row shading to make your data more compact and easier to read. Click the
on/off orange icon to turn grid style off.
Use these navigational controls to navigate the pages in the document list.
The fields that appear in the item list are based on the selected view, which you can edit. You can also edit a
view to rearrange the order that the columns display. Contact your Relativity administrator to change the
fields in your view.
To change a column’s size, hover over the white line at the edge of the column header. A double arrow
appears, indicating that you can resize the column. Drag it in either direction to adjust the column width. The
other columns on the page automatically adjust to fill the rest of the window. Column data can be cut off. If
you wish to return to the original settings click the Reset Column Sizes icon.
Note: Once you have frozen a column or columns, you can freeze additional columns to the right of
the frozen columns by repeating steps 1-2.
n Hover your cursor over the right-most frozen column, click on the ellipses, and select Unfreeze
Columns.
n
Click the unfreeze column icon in the upper-right section of the list.
1. In the column that you wish to copy, hover your cursor over the column's title and click on the ellipses.
2. Select Copy column values.
A modal displays the total number of column values that were successfully copied to clipboard.
Note: If your item list does not contain the file icon, contact your Relativity administrator to add it.
8.4.4.5 Sorting
You can use any field in the view to sort all of the results in an item list.
Click any field heading once to sort the items in that field in ascending order, alphabetically. A down arrow
appears next to the heading name, as in the Responsive field below. Click a second time to sort the items in
descending order, alphabetically. An up arrow appears. Clicking the field name a third time clears the sort
and returns the field to its original order.
If you are not able to sort a particular field, contact your administrator to make sure the field has the Sort
option set to Yes.