# Translator Space

### Overview

The **Translator** Space allows users to easily translate Microsoft Word, Excel, and PowerPoint files — or large blocks of text — from one language to another using a simple interface.

A difference from the Chat Interface is the delivery of responses. Instead of streaming responses incrementally, the Translation Interface delivers the entire translated output synchronously, providing a stable and predictable experience.

Additionally, Unique allows Admins to **include a glossary** by implementing pre- and post-processing steps.

This feature is currently in `BETA`. It may change before general availability, due to user and client feedback, but it targeted to be high quality and stable. Documentation may lag behind feature updates. Use in production environments at your own discretion. Please refer to our [Upgrade and Release Process](https://docs.unique.ai/it-operators/installing-and-upgrading-unique/upgrade-and-release-process) for more information.

If you’re unable to access certain features or sections of this article, it’s possible that your firm doesn’t have access or hasn’t upgraded to the latest version. Please reach out to your internal support team for further assistance.

### Who is it for

This feature is intended for Administrators, Developers, and Product Managers who are tasked with enhancing translation results by tailoring them to align with the company's glossary.

**Role Requirements:** To create a new space, you must have the `admin.space.write` role. For more information about roles, click here: [Understand Roles and Permissions](https://docs.unique.ai/it-operators/identity-and-access-management-iam/understand-roles-and-permissions)

### Benefits

- **Enhanced Translation Quality:** Unique allows Admins to integrate a **Glossary** during Pre-Processing and apply Post-Processing steps (e.g., converting American English to British English).

- **Automatic Language Detection:** No need to manually specify the language of the text for translation.

- **Streamlined User Interface:** Designed for ease of use by end users.

# Step-by-Step Guide

### Step 1: Create a new Translator Space

- Navigate to **Space Management** on the side navigation bar

- Click on **Create Space**

- Select **Translator**

For more information on how to setup a space other than Unique AI, check: [Create Spaces](https://docs.unique.ai/administrators/space-management/create-spaces)

### Step 2: Configure your Translator Space

#### **Add Name and Description**

Add a space name (e.g., Translator), a description of the space and a disclaimer text for the end users.

#### **Modify AI Assistant and Advanced Settings**

Make sure that **Translator V2** is set as the **exclusive AI Module** for both the AI Assistant and the Fallback AI Module.

If the **Translator V2** AI Assistant is not available to you via Dropdown, you might need to first create an AI Module Template as described here: [AI Module Templates](https://docs.unique.ai/administrators/space-management/create-spaces/unique-custom-space/add-ai-assistant-and-modules/ai-module-templates)

The “Translator V2” module is **standalone and can not** be combined with other modules.

#### **Incorporate Glossary** in Pre-and Post Processing

The Translator Space can be adapted to align with your organization's glossary during pre- and post-processing steps, enhancing the quality of your translations.

More details on how to configure the `Translator V2` module can be found [here](https://docs.unique.ai/administrators/space-management/create-spaces/unique-custom-space/add-ai-assistant-and-modules/translator-v2)

- The text can be pre-processed with a pre-defined **glossary** to have a consistent translation of your choice of words in the target language. [Glossary service](https://docs.unique.ai/administrators/space-management/create-spaces/unique-custom-space/add-ai-assistant-and-modules/translator-v2/glossary-service)

- Similarly, the text post translation can also be customized (e.g., to convert from American to British spellings). [Text Post Processing](https://docs.unique.ai/administrators/space-management/create-spaces/unique-custom-space/add-ai-assistant-and-modules/translator-v2/text-post-processing)

#### **Modify Advanced Settings**

1. In the “Advanced Settings” section, click the pencil icon button.

2. Make sure the `userInterface` is updated from “CHAT” to **“TRANSLATION”**.

The following setting will show the **translation interface**:

```json
"userInterface": "TRANSLATION"
```

The following setting will show the **chat interface**:

```json
"userInterface": "CHAT"
```

### Suggested Prompts and Access Management

For more information on how to setup a space other than Unique AI, check: [Space Management for Admins](https://docs.unique.ai/administrators/space-management)

### Step 3: Publish your Translator Space

If you've finished setting up and customizing the translator Space, be sure to publish it by clicking the "Publish" button in the top-right corner.

# Restrict Document Types

At the moment we only support uploading **.docx, .pptx and** **.xlsx** files for document translation.

By default, the document translation feature allows uploading .docx, .pptx and .xlsx files. However, if you want to restrict the file types to only or several types, you can use the `FILE_TYPES_DOCUMENT_TRANSLATOR` environment variable located in the `next-chat` frontend application.

**Example how to set:**

```json
FILE_TYPES_DOCUMENT_TRANSLATOR: 'docx'
```

This will only allow the upload of docx files in the document translation interface for example.

For unsupported file types, please convert them to a supported format (.docx, .xlsx, or .pptx) yourself first, then upload for translation.

# Limitations

- Only supports Microsoft Word **(.docx)**, Excel **(.xlsx)**, and PowerPoint **(.pptx)**

- PDF and other file types are not supported

- Language options are restricted to those in the dropdown; contact your admin for others

- Translated files may experience some layout disruption.