Last date modified: 2026-Jun-08

Imaging Warnings

The Imaging Warnings object identifies possible cut-off content in imaged MSG and EML files and stores that information for review.

Relativity supports the following email file types for imaging: MSG, P7M, P7S, ICS, VCF, EML, EMLX, and TNEF. However, imaging warnings are only generated for EML and MSG file types.

To view a list of documents that have imaging warnings, go to the Imaging Warnings tab. You can also add imaging warning fields to a Core Reviewer layout or a document view.

Special considerations

Note the following when working with imaging warnings:

  • If you delete an image, the imaging warnings associated with that image remain.
  • If you delete a document that has associated imaging warnings, the warnings are no longer visible and cannot be searched.
  • Relativity does not perform warning detection on images uploaded using the image replacement feature in the Document viewer.
  • Relativity does not perform warning detection on documents longer than 25 pages.
  • Documents longer than 25 pages are marked as Cut-off Detection Not Performed in the Warning Type field.

Imaging Warnings tab

The Imaging Warnings tab displays information related to current Imaging Warnings.

Imaging Warnings tab

Previous imaging warning information is not preserved. If a document with an imaging warning is re-imaged, the prior imaging warning is deleted.

Imaging Warning layout

When you click the Imaging Warning field for a document, the Imaging Warning layout opens.

Imaging Warnings layout

You cannot access the Imaging Warning layout from the Documents tab. To open the Imaging Warning layout, go to the Imaging Warnings tab or the Core Reviewer layout, then click the Imaging Warning field for a document.

The Imaging Warning layout has the following fields:

  • Relativity Document Identifier — The control number of the document, with a link to the document in the Viewer.

  • Imaging Warning — A description of the problem detected. Description options are:
    • Possible cut-off embedded image detected.
    • Possible cut-off text detected.
    • Cut-off detection not performed.
    • Split performed on table larger than page width.
    • Possible missing or invalid Rich Text Format content detected in the email body.
    • Possible invalid character coding detected.
    For more information, see All imaging warnings.
  • Warning Type — A predefined list of options for grouping and searching warnings. This field has better search performance than a text-based field such as Imaging Warning. Warning types include:
    • Cut-Off Embedded Image
    • Cut-Off Detection Not Performed
    • Table Split
    • Missing or Invalid Rich Text Format Content
    • Character Encoding Mismatch
  • Warning Details — Additional information about the problem, such as the page range where issues are detected.
  • Imaging Method — The method used to image the document: Basic or Native.
  • Native Type — The file type of the document before imaging.
  • Job Type— The method used to create the image. Job types include:
    • On-the-fly
    • Mass imaging
    • Imaging Set
  • Imaging Set — The imaging set used to produce the image, when the job type is Imaging Set. Click the imaging set name to open the Imaging Set Layout.
  • Notes — A space to enter notes about the imaging warning.

Except for the Notes field, you cannot modify the Imaging Warning fields, and you cannot link or unlink Imaging Warnings to documents.

Warning Type pivot table

In the Imaging Warnings tab, you can create a pivot table based on the Warning Type field and then export the pivot or dashboard. See Running Pivot reports and Dashboards.

An image of a pivot table based on the Warning Type field

You can only create the Warning Type pivot in the Imaging Warnings tab. The Warning Type field is not available for widgets on the Documents tab.

All imaging warnings

The following table lists the all the imaging warnings:

Imaging Warning Type Why this warning occurred Recommended action
Character Encoding Mismatch

The text in this document may be encoded in a way that produces invalid or unreadable characters when imaged. The email metadata indicates the message body uses one character encoding, but part of the body text uses a different encoding. Example formats include:

  • UTF-8
  • Windows-1252
  • us-ascii

Create a saved search with this warning type as a search condition and manually QC the returned documents. See Creating or editing a saved search.

Cut-Off Detection Not Performed Email that is greater than 25 pages cannot have cut-off detection performed on it. See Special considerations. Create a saved search with this warning type as a search condition and manually QC the returned documents. See Creating or editing a saved search.
Cut-Off Embedded Image Embedded images within a table go beyond the boundaries of the page. Use different imaging profile options, such as landscape, auto-fit tables, split tables and auto-fit images. See Imaging profiles.
Cut-Off Text Text within a table goes beyond the boundaries of the page. Use different imaging profile options, such as landscape, auto-fit tables, and split tables. See Imaging profiles.
Missing or Invalid Rich Text Format Content

The rich text data in the email body may be missing or incorrect. As a result, text in the email body may be missing from the generated image.

Create a saved search with this warning type as a search condition and manually QC the returned files. See Creating or editing a saved search.
Table Split

Tables that go beyond the boundaries of the page have been split and re-printed on a new line.

Create a saved search with this warning type as a search condition and manually QC the returned files. See Creating or editing a saved search.

Table Split Not Completed Tables that are beyond boundaries of the page could not be split. Reasons for this include an abnormally wide first column, when there are rows that span across multiple columns, or a table within a table. The exact page where the table begins will be reported.

Use different Imaging Profile options, such as landscape, auto-fit tables, and split tables. See Imaging profiles.

Core Reviewer layouts

To facilitate the QC of documents, you can link the Imaging Warnings layout to a Review layout. See Adding and editing an object list and Imaging Warning layout.

You can also add Imaging Warnings fields to a Core Reviewer layout. The Core Reviewer layout can be configured to show Imaging Warning details or create pop-ups with that information. See Layouts.

Imaging Warnings fields that you can add to a layout include:

  • Imaging Warning
  • Warning Type
  • Warning Details

For field descriptions, see Imaging Warning layout.

Re-imaging emails with tables

You can image large tables in emails without the table being cut-off in the resulting image by setting the Split tables to fit page width field in the Native imaging profile to Yes. When this field is set to Yes, wide tables are split and re-printed on a new line when they are imaged with no content lost.

The following screen shot shows an imaged email where the Split tables to fit page width field was set to No on the imaging profile.

An imaged email where the Split tables to fit page width field was set to No on the imaging profile.

This screen shot shows an imaged email where the Split tables to fit page width field was set to Yes on the imaging profile.

An imaged email where the Split tables to fit page width field was set to Yes on the imaging profile.

Setting the Split tables to fit page width field to Yes slows down imaging time. Consider imaging documents without this setting first, then re-imaging documents that receive an imaging warning.

To re-image documents that have an imaging warning:

  1. Create a saved search that brings back documents with Imaging Warnings.
    • Select Imaging Warning from the Add Condition drop-down menu. A dialog box opens.
    • Select these conditions from the Operator.
    • Click Add Condition and select Imaging Warning::Warning Type.
    • Select any of these from the Operator drop down.
    • Move Cut-Off Embedded Image and Cut-Off Text from Available to Selected and click Apply.
      (Click to expand image)
      Saved search conditions pop-up
    • Click Apply.
    For more information, see Creating or editing a saved search.
  2. Delete the images in documents that have Imaging Warnings.
    • Filter on the saved search you created.
    • Select Delete from Mass Operations.
    • Select Delete only images from selected documents.
    • Click Delete.
  3. Create a Native Imaging Profile, and in the Email Options tab, set the Split tables to fit page width field to Yes. For more information, see Imaging sets.
    Native Imaging Profile
  4. Create an Imaging Set.
    • Select the saved search you created for Data Source.
    • Select the native imaging profile you just created for Imaging Profile.
    • Click Save.
    For more information, see Imaging sets.
  5. Open the Imaging Set.
  6. Click Image Documents from the Imaging Sets console.
Return to top of the page
Feedback