Translate

With Translate, you can select a set of documents that are in different languages and translate them to another language so that they can be searched and reviewed. You can also translate a single document from the Viewer. For dozens of file types, including Microsoft Office files and PDFs, you can receive a translation in the native format of the document, along with the translated extracted text. After successfully starting a Translate job, you will receive an email notifying you when it has completed along with a link to the translated documents.

Each document that is successfully translated is charged to you individually. Each errored document will not incur any charge to you. Translated documents can then be seen in either the native format or the translated language in the Translation Viewer.

This page contains the following information:

Translate requirements

  • Translate is a separate application that must be installed into your instance, and desired workspaces. For more information, see Installing the Translate application.

  • You must have an enabled RelativityOne license to use Translate.

  • Translate is not available for certain file types and in certain regions.

  • Relativity can revoke or limit access to Translate if it is used in an unauthorized manner. Translate cannot be used by customers or third parties to, directly or indirectly, create, train, or improve a similar or competing product or service.

Installing the Translate application

If you are a RelativityOne customer and would like to access the Translate application, please contact your Account Executive.

Note: Translate is compatible with client domains. You can limit access by installing the Translate application in workspaces with client domains. You can also configure permission levels per workspace based on end-user needs.

Once the Translate application has been installed in your instance, you can install it to any workspace you would like. To install Translate to a workspace:

  1. In the workspace you wish to install Translate, navigate to the Relativity Applications tab.

  2. Select the Select from Application Library option.

  3. Click on the Select icon.

    The Select Library Application pop-up displays.

  4. Filter the applications as desired and select the RelativityOne Translate application.

  5. Click Ok.

  6. Click Import.
    The Translate application is installed and ready for use in the workspace.

Translate permissions

The following permissions are needed to access Translate functionality:

Object Security Tab Visibility Other Settings
  • Document
    • Translate Document
  • Translated Documents - View
 
  • Mass Operations
    • Translate

Each permission enables a user to complete different tasks with Translate. By default, Translate permissions are enabled for system admins only.

A brief description of each permission is provided below.

  • Document: Translate Document—if enabled, users can translate a single document in the Viewer. To learn more, see Translating a single document.

  • Translated Documents: View—if enabled, users can see translated documents in the Translation Viewer.

  • Mass Operations: Translate—if enabled, users can run Translate jobs that contain multiple documents at once using the Translate mass operation. To learn more, see Translating multiple documents.

    Note: There is a limit of 1,000 documents that can be translated in a single job by default. You can adjust this limit by editing the value of the TranslateMassOperationMaximum instance setting.

Translating multiple documents

To translate documents to a new language:

  1. Navigate to the Documents tab.

  2. Select the documents from the list that you wish to translate to another language. These documents can contain multiple languages. A document cannot be larger than 40 MB. To view a list of document file types that are supported, see Additional file limits may apply.

    Note: If a document needs to be re-translated in the same language it was previously translated in, you can delete the Translation Relativity Dynamic Object (RDO) to translate that document again to the same target language.

  3. Click on the mass operations toolbar and select Translate.

  4. Complete the fields in the Translate documents modal. To learn more, see Fields.

  5. Click Translate X documents.
    The modal displays a message on whether the Translate job started successfully or not. Once started, jobs may be broken up into smaller jobs for performance reasons. Once the job finishes, you will receive an email with a summary of the results and a link to the translated documents. If the job did not start successfully and you would like more information, see Troubleshooting Translate jobs.

  6. Optionally, you can download a copy of the translated native file by clicking on the Document actions menu and hovering your cursor over the Download translated document option and selecting the desired language you wish to download.

  7. To view a translated document, select the document from the Documents list.

    Note: When a document is translated, a Translation RDO is created to store the translated document which is then linked back to the original document to ensure it is preserved.

  8. Select the Viewer option named after the translated language. For example, if you translated a document to English, click on the English Viewer.
    The translated document displays in the Viewer.

Translating a single document

To translate a single document on-the-fly to a new language:

  1. Navigate to the Documents tab.

  2. Select the document you wish to translate from the list. A document cannot be larger than 40 MB. To view a list of document file types that are supported, see Additional file limits may apply.

    Note: If a document needs to be re-translated in the same language it was previously translated in, you can delete the Translation Relativity Dynamic Object (RDO) to translate that document again to the same target language.

  3. Click the Translate button.

  4. Complete the fields in the Translate documents modal. To learn more, see Fields.

  5. Click Translate 1 document.
    The modal displays a message on whether the Translate job started successfully or not. Once started, jobs may be broken up into smaller jobs for performance reasons. Once the job finishes, you will receive an email with a summary of the results and a link to the translated documents. If the job did not start successfully and you would like more information, see Troubleshooting Translate jobs.

  6. Optionally, you can download a copy of the translated native file by clicking on the Document actions menu and hovering your cursor over the Download translated document option and selecting the desired language you wish to download.

  7. To view the translated document, click Exit viewerand then select the document from the Documents list.

    Note: When a document is translated, a Translation RDO is created to store the translated document which is then linked back to the original document to ensure it is preserved. The Translation RDO does not count against storage costs.

  8. Select the Viewer option named after the translated language. For example, if you translated a document to English, click on the English Viewer.
    The translated document displays in the Viewer.

Fields

The following fields can display in the Translate documents modal:

  • Translate To—select the language you wish to translate the current document to.

    Note: Translate automatically detects the language of the current document. Hidden content, such as notes, comments, or hidden cells, are translated as well. Attachments and embedded documents are not translated by this application, however.

  • Translation Source—select the document source for this translation:

    • Native—if selected, the original document file will be used for the translation. When this option is selected, the If Native unsupported, translate Text field displays in the modal.

      Note: Certain file types can be translated in their original format. A full list of file types, encodings, and other limitations can be found in the modal by clicking on Additional file limits may apply.

    • Text—if selected, the extracted text will be used for the translation. The Source text field option displays in the modal.

      If Native unsupported, translate Text—enable this option to automatically translate the extracted text from the selected Source text field if the native document’s format cannot be translated. We recommend enabling this option. If enabled, the Source text field displays in the modal.

    • Source text field—select the long text field you would like to translate. Any long text field that has the Available in the Viewer option enabled will appear in this drop-down menu. This option only displays if either Text is selected or If Native unsupported, translate Text is enabled.

    • Translate job estimate—click on this link in the modal to view an estimate of the total number of documents that will be translated with this job. Each document unit that is successfully translated will incur a charge. The estimate is based on the selected Source text field.

      Note: This is an estimate and does not account for numbers, which are non-translatable characters. It also does not account for additional content that Translate finds during the translation process that wasn’t recognized by Relativity’s OCR or text extraction tools.

    • Additional file limits may apply—click on this link in the modal to view Translate's file limitations, including document type and file size limits.

Populated fields

The following fields are populated for documents once a Translate job has finished:

  • Relativity Translated Extracted Text—this field is populated with all of the translated extracted text, even if a document is translated multiple times to multiple languages.

  • Translation Document Source—this field is populated on the original document, and is named with the control number and target language. This is a multi-object field that can be used to identify which documents have been successfully translated and to what languages.

Working with translated documents

Documents that have been translated function differently than other documents in Relativity. When a document is translated, a Translation RDO is created to store the translated document which is then linked back to the original document to ensure it is preserved. The Translation RDO does not receive a control number and is not be stored as a separate document.

Redact is not compatible with translated native documents.

Once a document is translated, the Relativity Translated Extracted Text field is created. This long text field is populated with the translated extracted text and can be used in various types of searches. You can also use the Relativity Translated Extracted Text field to build out analytics indexes.

Viewing a job's status

You can see the details of a Translate job, including whether it was successful and when it finished from the Translate Jobs tab. Each document that is included in a job is listed separately on this tab. The Translate Jobs tab is available at both the instance-level and workspace-level. The information that displays is determined by workspace permissions and lockbox settings.

Optionally, click the Export to CSV icon to download a .csv file that contains the information on the Translate Jobs tab.

The columns on the Translate Jobs tab are described below:

Column Description
Job ID Displays the unique ID that is generated for each Translate job.
Job Status Displays whether a Translate job has finished successfully, errored, or is still pending.
Doc Ctrl # Displays the control number for the document included in the job. You can click on the document's control number to open it in the Viewer.
File Type Submitted Displays whether the document included in a translation is native or extracted text.
Target Language Displays the language that the document is translated to.
Doc Units

Displays the number of documents that have or will be translated by this job. This is the number of documents you will be charged for using this service as well.

Any character on the document you are translating, excluding numbers, is counted as a character. Output characters affect the calculation for Doc Units as well.

Note: A document unit contains 25,000 characters or less. For example, if you translate a document that has 20,000 characters and a document that is 27,000 characters, the first document would count as 1 document unit and the second document would count as 2 document units because it has over 25,000 characters.

User Name Displays the user that started the Translate job.
Job Group Displays the unique ID that is generated for the document.
Request Time Displays the date and time when each Translate job was submitted.
Completion Time Displays the date and time when each Translate job completed.
Doc ID Displays the Artifact ID for each document.
Job Failure Reason Displays the reason why a Translate job was not successful which can be shared with Relativity Support to help you troubleshoot. If a native document was not successful, try translating the extracted text instead.

Supported Languages

The languages supported by Translate vary for documents and scanned PDF documents. You can click the links below to view additional information.

Troubleshooting Translate jobs

If you start a Translate job and do not see a notification that it started successfully, you will see one of the following messages instead. Information on how to troubleshoot these scenarios is also provided below.

Notification Troubleshooting Tips
Translation Job failed. For assistance with resolving this notification, contact Relativity Support..
Translation job started, but with the below file warnings.

This message displays if the job starts but Translate identifies potential native documents that will not be translated because the file type is not supported or the document file size is over 40 MB.

If the document file size is too big, try translating the extracted text instead.

Translate uses the Relativity Native Type field (and it’s associated File ID) to determine the file type. If that field is Unknown format type, the original document cannot be translated.

You can click on the Save X untranslated documents as a Saved Search link to access the files which will not be translated.

Note: If documents are in a secured folder and fail to be translated, ensure that the user trying to translate them has the Translate Documents permission on that folder. Otherwise, the user will see an "Insufficient Permission" message.

Once a Translate job finishes, you may see the any of the following messages in the email that is automatically sent to you.

  • ServiceUnavailable: The document or part of its content is unsupported.

  • Document cannot be opened due to possibly being corrupt.

  • Document failed during checking validity. This may be caused by corruption or unsupported type/extension.

  • Job has timed out.

If you receive any of these notifications, we recommend trying to translate the Native document again. If this does not resolve the issue, try translating the extracted text of the affected documents instead. If you are still receiving this email notification after trying both of these potential solutions, contact Relativity Support.