Short Message Viewer

The Relativity Short Message Viewer displays conversations or individual messages sent using SMS such as iMessage and instant messenger services such as Skype Messenger, Slack, Bloomberg, etc. To learn more about the RSMF files which allow you to view short message data, visit Relativity Short Message Format.

Note: You can determine the maximum document file size in megabytes that can be loaded in the Short Message Viewer by editing the value of the MaximumNativeSizeForViewerForRSMFFilesInMegaBytes instance setting. To ensure stable performance, we recommend entering a value of 250 or less.

Using the Viewer's built-in search capabilities, the Short Message Viewer allows you to find participant names, specific statements, or emojis in conversations. Additionally, you can easily find what was said during a particular time period by using the Timeline Navigator.

Note: Starting in Relativity 12.1.2, the Short Message Viewer supports RSMF 2.0 and 1.0. RSMF 2.0 enriches the data captured within Relativity Short Message Format and enhances the user interface within the Viewer. If you are viewing an RSMF 1.0 file, the user interface may differ from the images below. While we recommend leveraging RSMF 2.0 to ensure the best experience in the Short Message Viewer, both versions are supported in Relativity. For more information about what has been added to RSMF 2.0, see New RSMF 2.0 functionality.

The Short Message Viewer with the Coding Layout expanded.

See these related pages:

Short Message Viewer

Short Message Viewer displays an HTML rendering of the message or conversation including attachments, reactions, events, and emojis. The Viewer provides options for navigating through a single document and between documents in a document set. In Short Message Viewer you can also conduct text searching and highlighting text to copy and paste.

Short Message Viewer toolbar options

The Short Message Viewer provides the following toolbar options:

Note: Relativity automatically hides toolbar buttons and controls that aren't applicable to the currently loaded document type so that your toolbar isn't cluttered while you're reviewing documents.

The Short Message Viewer toolbar options.

  • 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 Short Message 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've 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.
  • Reset Zoom - resets the zoom to 100%.
  • Fit Width - increases the size of the document to fit the maximum width of the Viewer. This setting persists when you re-size the window.
  • Fit Page - fits the entire document into the total size of the page. Clicking this zooms out the document and reduces the font size.
  • 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%.
  • Layout Mode - select one of the following options to determine how documents that are more than one page long display in the Viewer.
    • 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.
    • Single Continuous - Displays the pages in the document stacked vertically so you can scroll up and down to view them.
    • Facing Continuous - Displays the pages in the document in a row horizontally so you can scroll left and right to view them.
  • Go To Next/Previous Highlight - moves through previous and next highlighted terms in the document.
  • 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.
    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.
  • Search Bar - searches for terms in the current document and navigates through the hits.
    • 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).
    • Searching in this text box is not case sensitive.
    • The Search Bar supports dtSearch and so proximity, fuzziness, and stemming can be used. To learn more about this search functionality, visit dtSearch.
  • You can search for emojis using any of the following methods:
    OptionDescription
    Search using copy and pasteIf you would like to search for an emoji that displays in the Short Message Viewer, do the following:
    1. Highlight the desired emoji.
    2. Either right-click on the emoji and select Copy or press Ctrl+C on your keyboard.
    3. Either right-click in the Search Bar and select Paste or click in the Search Bar and press Ctrl+V on your keyboard.
    Search using an emoticonIf you would like to search for a popular emoji that has an emoticon, you can find the emoticon by visiting RSMF-supported Emoji Emoticon and Attachments. To search using an emoticon, do the following:
    1. Either type the emoticon or copy and paste it into the Search Bar.
    2. Press Enter on your keyboard or click to navigate to the first search result.

Left drawer Short Message Viewer options

The following options are available in the left drawer:

The Left drawer Show Message Viewer icons

  • 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. To learn about persistent highlight sets, see Persistent highlight sets.
    You can search for emojis in a search terms report or the Search Bar. You can only search for emoji short names using search terms reports in the Extracted Text Viewer. To find an emoji's short name, visit RSMF-supported Emoji Emoticon and Attachments.

Two persistent highlight sets within the Persistent Highlighting panel.

  • Thumbnail - click to expand the left drawer and display the Thumbnail Viewer and view a thumbnail version of the current document. Each page of the document you're reviewing has its own numbered thumbnail. To learn more, visit Thumbnail Viewer.
  • Filter - displays or hides a panel containing all filters. Short Message Filtering allows users to quickly locate and investigate messages leveraging the following data dimensions: conversations, participants, events, and dates. See the table below for more information on what data is pulled in from the RSMF file to populate these filters’ values. For more info on the RSMF file format, visit Relativity short message format.
  • Filter Category Data from RSMF File
    Conversations In the ‘conversations’ dictionary, there is a field called “display”, that relates to “id”, and is used to populate the conversations filter.
    Participants In the ‘participants’ dictionary, there is a field called “display”, that relates to “id”, is used to populate the participants filter.
    Events In the ‘events’ dictionary, there is a field called “type”, which is used to populate the events filter.
    • For RSMF 2.0, event types include: message, join, leave, disclaimer, history.
    • For RSMF 1.0, event types include: message, join, leave, disclaimer.
    Dates In the ‘events’ dictionary, there is a field called “timestamp”, the date filter uses to focus on messages in a certain timeframe.

If a filter is selected and the Show filtered out events option is disabled, the Viewer will only display messages that meet the criteria. If a filter is selected and the Show filtered out events option is enabled, each message that does not meet the criteria will display but is grayed out to distinguish it from the messages that do meet the current filter options.
When filtering is applied to the conversation, all message activity bars that do not meet the filter criteria will be grayed out in the Timeline Navigator. If multiple filters are selected within a specific filter category, OR logic is applied to those criteria. When making selections across multiple filter categories, AND logic will be applied. In other words, all selections within a filter category are additive to your results due to the OR logic, and selections across filter categories are subtractive to your results due to the AND logic.
Optionally, you can keep the Event Types and Time Range fields set as you navigate from document-to-document in the Short Message Viewer. After selecting an option in either section, click on the Lock term icon to keep that option set for the rest of this session or until you click on the Lock term icon again. If you lock options and no messages meet your filters, No events are visible under the current filter settings. displays.

The Short Message Viewer displays with the Filters card expanded. The user toggles various options to show how filtering messages controls what displays in the Viewer.

  • Sentiment—click to expand or collapse the left drawer and display sentiment analysis highlights in the Viewer. To learn more, visit Sentiment analysis highlights.
  • aiR for Review Analysis—click to expand or collapse the left drawer and display aiR for Review results. You can also enable or disable aiR for Review highlights. To learn more, see aiR for Review Analysis.

Right drawer Short Message Viewer options

The following option is available in the right drawer:

The right drawer Short Message Viewer icons.

  • Contextual Search - click to expand the right drawer and display the Contextual Search Pane. 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 Pane 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.

The Short Message Viewer displays with the Contextual Search pane expanded. The user enters a search term into the Contextual Search pane and clicks on several results to show how navigation works.

  • RSMF Validation - When an RSMF document fails to load in the Viewer, click this icon to display information about potential issues with the RSMF file. The RSMF Validation card is intended to help you discern whether there is an issue with an RSMF file.

The Short Message Viewer offers a number of features to make finding the desired information in a conversation as easy as possible.

Platform Icon

The following table displays the different platform icons that can display in the Short Message Viewer. If a file does not contain any information about the messaging platform, the SMS platform displays by default.

Icon Name of Platform Platform Value in RSMF
The Slack icon Slack slack
The SMS icon SMS or MMS sms or mms
The Bloomberg icon Bloomberg bloomberg
The Skype icon Skype skype
The iMessage icon iMessage imessage
The Google Hangout icon Google googlechat, google hangout, googlehangout
The OpenAI logo OpenAI openaichatgpt
The Microsoft Teams logo Microsoft Teams msteams, teams

Conversation Pane

The Conversation Pane displays a list of the conversation's participants as well as the exact number of messages that were sent during the RSMF file's duration.

The Conversation Pane which displays at the top of the Short Message Viewer.

To view additional information about the conversation such as start and end date, participants, and any additional custom data, hover your cursor over the platform icon.

An example of the modal that displays when you hover your cursor a platform icon.

To see which participants used a reaction or completed an event, hover your mouse over the reaction/event. Slack messages will only display up to 50 reactions per individual reaction.

An example of a modal that displays when you hover your cursor over a reaction.

To see an enlarged version of an emoji and a short description of it, hover your cursor over it.

An example of the enlarged emoji modal that displays when you hover your cursor over one.

Additional information displays to the right of each message to indicate whether a message was tagged by a participant as important or EDITED or DELETED displays to indicate a participant changed or removed that message from the conversation. For Slack messages, hover over the The question mark icon. to view the original and edited messages.

A message displayed in the Short Message Viewer that was deleted.

By hovering or clicking on the direction icon to the right of a message, users can see what direction this message was sent (incoming or outgoing), which may help give an indication of who the custodian was. This feature is only available when viewing RSMF 2.0 files.

An example of the direction message modal in the Short Message Viewer.

By hovering or clicking on the delivered or read icon, a modal with additional information will be displayed. You can filter or sort the modal as desired to locate relevant information. This feature is only available when viewing RSMF 2.0 files.

The Read modal displays.

You can view a history event by hovering your cursor over the icon. A history event is intended to capture when a participant reviewed the history of the chat and the dates of the historical chats they reviewed. This feature is only available when viewing RSMF 2.0 files.

An example of a history event and the respective modal.

If there are image files that are either a jpg, jpeg, png, or gif and you have the Document - Local Access (Download, Copy Text) permission granted, the images will be placed in-line within a message. You can click on the image to expand it.

If you do not have the Document - Local Access (Download, Copy Text) permission and you wish to the view the image, open that attachment as a separate file in the Native Viewer.

An example of an image that is displayed in-line  in the Short Message Viewer.

Note: Starting in Relativity 10.3.142.22, you cannot upload duplicate attachments to a single message.

Viewer interface for missing information

The Short Message Viewer attempts to display as much information in the RSMF file as possible, even if some information might be incomplete or spoiled. For example, if a custodian deletes texts from their phone this can cause the data to be incomplete when collected. We recommend reaching out to your source of RSMF files to confirm that this data is indeed missing from the collection source.

Note: If an RSMF file contains a chat with no messages, you will not be able to view any of the contents of that RSMF document in the Short Message Viewer.

Below are some examples of unique interfaces you may see in the Short Message Viewer and what they mean:

Validation card

When an RSMF document fails to load in the Viewer, a card displays that explains potential issues with the RSMF file. The Validation card is intended to help you discern whether there is an issue with an RSMF file.

The Short Message Viewer displays an RSMF document that failed to load.

Reconstructed conversation

This displays if there were events or messages that have a conversation ID in which they occurred, but that conversation doesn’t match any of the conversations in the RSMF file.

An example of a short message conversation that was reconstructed.

Unknown conversations

This displays if there were events or messages that have a missing or invalid associated conversation in which they occurred and that conversation isn’t present in the broader RSMF file.

An example of an Unknown Conversation in the Short Message Viewer.

Missing timestamps

This displays if an event does not have a timestamp. Events that are missing a timestamp will be displayed at the top of the conversation since they cannot be arranged in chronological order.

An example of a conversation that is missing a timestamp in the Short Message Viewer.

Undefined participant

This displays when a participant is not identified for an event.

An example of an Undefined Participant in the Short Message Viewer.

Participant #

This displays when a participant who sent a message is not specified in the RSMF file.

A message sent by Participant 1 in the Short Message Viewer.

Orphaned Replies

An event with a parent message, but the parent message is not provided in the RSMF file.

An orphaned reply in the Short Message Viewer.

Troubleshooting attachments

If the Short Message Viewer shows an error on the attachments, see Processing an RSMF file.

An attachment with an error in the Short Message Viewer.

RSMF Slicing

This feature allows you to select events in a conversation and "slice" them to create a new document. The new, sliced document can then be produced like any other document in Relativity. To learn more, visit RSMF Slicing.

Timeline Navigator

The Timeline Navigator at the bottom of the Short Message Viewer allows you to track the duration and message activity within a conversation. You can also view event activity with an RSMF file in the Timeline Navigator.

To quickly jump to a particular date, click in the Timeline Navigator and the conversation in the Short Message Viewer will move to the selected time. As you scroll through the messages, a blue highlight window will display in the Timeline Navigator to indicate where you are in the conversation.

An example of the Timeline Navigator

To view additional information about the conversation on a particular date or time, hover your cursor over the desired time in the Timeline Navigator.

Additional information about a date or time displays in the Timeline Navigator.

If you have active persistent highlights or search highlights, any bars in the Timeline Navigator that contain highlights display in orange. When filtering is applied to the conversation, all message activity bars that do not meet the filter criteria will be grayed out, but still visible.

Click on the desired bar to conveniently navigate to the desired highlight.

An example of some dates and times that have search highlights and other dates and times that do not.

You can re-size the Timeline Navigator by left-clicking and dragging the top of the Navigator to the desired size.

A gif that shows a user resizing the Timeline Navigator.

You can click to the Message Timeline icon in the bottom-left to minimize the Timeline Navigator. To return to displaying the Timeline Navigator at its previous size, click the Message Timeline icon.

The Message Timeline icon

Copying text in the viewer

While viewing a document in the Short Message Viewer, you can copy text from the document you're currently viewing and then paste it into another application.

To do this:

  1. Highlight either the text in a single message or the entire text from multiple messages that you want copied.
  2. Right-click, and then select Copy from the menu.

You can't copy text if you:

  • Haven't highlighted any text.
  • Don't have permission to the Local Access option on the Document object. This is the same permission that permits you to open the file in its native application. For more information, see Object list in the Workspace security topic.

Audit Records

Audits populated when viewing an RSMF include:

  • "View" for an RSMF file
  • "Download" for in-line images on that RSMF file only (not for other attachments)

Adjusting the Time Zone in Short Message Viewer

The times displayed in the Short Message Viewer are in Universal Time Coordinated (UTC) format. To offset the time in the Short Message Viewer so you can compare it to another time zone, use the Relativity Native Time Zone Offset field in the Coding Panel. If the Relativity Native Time Zone offset field is used, the time difference is displayed after the message timestamp like the following example: 11:49 AM (UTC +02:00).

If there are RSMF events without a time zone specified in their timestamp strings, a warning message displays and Relativity will specify what time zone the messages are assumed to be in.

RMSF events with a time zone specified in their timestamp strings follow that time zone and are then converted to UTC. Any user who views this document in the Short Message Viewer, will see the same time regardless of their system time zone.

The Relativity Native Time Zone Offset field is highlighted in the Coding Layout pane.

Short Message Image Viewer

RSMF files function like documents in the Short Message Viewer with the exception of the Navigation features described below. For more information about imaging options, visit Image Viewer. Additionally, a document with an RSMF file and images that is produced will be treated like any other document in Production.

When emojis are rendered in HTML5, Relativity uses the native browser to render. When the emojis are imaged, the Google set is used. To learn more about the Google set, visit Emojipedia.

Beginning in Relativity 11.1.152.1, when RSMF files are imaged, all messages will be imaged, regardless of if any filtering was applied to the RSMF file in the Short Message Viewer. The image of the RSMF will mirror what you see in the Viewer, and will produce a PDF version of what you see in the Viewer.

Also beginning in Relativity 10.3.142.22, by default, we will add a ‘Summary Report’ to the first page of the imaged version of the RSMF file. Redactions and other edits are able to be applied to imaged version of the conversation, much like traditional email documents.

Imaging does respect the date format, “DD/MM/YYYY”, for example. The date used for Imaging is based on the Windows regional settings on a given machine as of Relativity 11.1.152.1.

The Relativity Short Message Format native type is set to use basic imaging in the Native Types tab. It is possible to image in color using the basic imaging engine by setting the Basic Image Format to JPEG on the imaging profile.

The Basic Imaging options section

The Short Message Image Viewer offers a number of features to make finding the desired information in a conversation as easy as possible.

Short Message Report and Outline of Conversations

Note: The Short Message Report is displayed by default when viewing images in the Short Message Viewer.

At the top of the RSMF file, the Short Message Report displays data about the messages contained within.

The Short Message Report displays in the Short Message Image Viewer

The Outline of Conversations displays underneath the Short Message Report and also contains statistical data about the messages. In addition, the name of each participant in the conversation also displays.

The Outline of Conversations which displays at the top of the Short Message Image Viewer.

If a participant enters or leaves a conversation, a message displays underneath their name and avatar to help you track who was involved in the conversation.

An example of a participant leaving a conversation.

If a reaction or event occurs in the conversation, the name of each participant who used that reaction or event displays next to it.

An example of reactions in a conversation.

Additional information displays to the right of each message to indicate whether a message was tagged by a participant as important or EDITED or DELETED displays to indicate a participant changed or removed that message from the conversation. When previous events are included, the Edit/Delete modals also include historical posts that you can sort and filter.

A message which displays the Edited tag to help reviewers identify the message status.

Messages that include read or delivered receipts display the time that the event(s) occurred underneath the message text. This feature is only available when viewing RSMF 2.0 files.

A message that has delivered and read receipts.

Messages can also include an arrow in the upper-right that indicates what direction this message was sent (incoming or outgoing), which may help give an indication of who the custodian was. This feature is only available when viewing RSMF 2.0 files.

A message that has an arrow indicated whether it was incoming or outgoing.

Short Message Image Viewer interface for missing information

The Short Message Image Viewer attempts to display as much information in the RSMF file as possible, even if some information might be incomplete or spoiled. Below are some examples of unique interfaces you may see in the Short Message Viewer and what they mean:

  • Conversations Display field - If this field is not available, the Viewer will display ‘Untitled’ instead.
  • Participant Display field - If this field is not available, Relativity will look for a fall back value that includes the ‘email’ value. If that value cannot be found, Relativity will then look for 'account_id'. If neither of those values are available, the Short Message Image Viewer will display ‘Unnamed [id]’, where [id] is the participant.id field.
  • Participant toolbar - If this is not available, Relativity will look for a fall back value that includes the ‘email’ value. If that value cannot be found, Relativity will then look for 'account_id'. If neither of those values are available, the Short Message Image Viewer will display ‘Unnamed [id]’, where [id] is the participant.id field.
  • Filtering - If this is not available, Relativity will look for a fall back value that includes the ‘email’ value. If that value cannot be found, Relativity will then look for 'account_id'. If neither of those values are available, the Short Message Image Viewer will display ‘Unnamed [id]’, where [id] is the participant.id field

Extracted Text Viewer

RSMF files can also be viewed in the Extracted Text Viewer if data is included in the Body. and the extracted text comes from the EML file. For more information about Extracted Text Viewer, visit Viewer.