# Multi-File Projects

Multi-file projects let you import a whole folder of files as a single Supervertaler project.

### Import a folder

1. Go to **File → Import → Folder (Multiple Files)...**
2. Choose a folder containing supported files (DOCX/TXT/MD)
3. Select which files to include
4. Choose the **source** and **target** languages

### How it behaves

* All segments live in one grid, but each segment is associated with a source file.
* You can jump between files and track progress per file.
* Each DOCX file is imported via the **Okapi sidecar** (the same engine that handles single-file DOCX import) – you get SRX segmentation, faithful round-trip, and hyperlinks/structural tags preserved per file.
* TXT and MD files use the simple per-line import.
* Original files are backed up to a `_source_files/` folder inside the project folder so the export can reconstruct each document faithfully.

### Export

When you export a multi-file project:

* Each DOCX file is reconstructed via the Okapi sidecar's `/merge` endpoint, using the original from `_source_files/` as the template. Layout, formatting, hyperlinks, and tables round-trip identically.
* TXT/MD files are written with the same per-line structure as the source.
* Output files land in the destination folder you choose, named `<original>_translated.<ext>`.

### Tips

* Use this when you receive a set of related files (e.g. claim documents, manual chapters split into separate files, UI strings split across documents).
* Export is done in one operation – pick the destination folder and Supervertaler writes all the translated files at once.

### Requirements

* The Okapi sidecar must be running before you import any folder containing DOCX files. Supervertaler checks this up-front and shows an "Okapi sidecar required" dialogue if it can't reach the sidecar – better than failing halfway through importing twenty files.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://supervertaler.gitbook.io/help/import-and-export/multi-file.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.