# Import & Export

MVS Web lets you bring accounts in from other tools and export them for backup or use elsewhere.

## Import

To import accounts, click the **Import** button on the [Accounts](/mvs-docs/accounts/account-management.md) page (top-right area).

### Supported Import Formats

| Format                         | Description                                                                                                                      |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| **Session files** (`.session`) | Telethon SQLite session files. Each file contains one account. This is the most common format used by Telegram automation tools. |
| **TData**                      | Telegram Desktop data folders. These contain session data from the official Telegram Desktop client.                             |
| **JSON**                       | Account data exported in JSON format from compatible tools.                                                                      |

### How to Import

1. Click the **Import** button on the Accounts page
2. Select the import format
3. Choose the files or folders you want to import
4. The imported accounts will appear in the table with status **new** and source **imported**

{% hint style="info" %}
After importing, run the [Checker](/mvs-docs/modules/checker.md) module on the imported accounts to verify their status and fill in missing information (username, premium status, account age, etc.).
{% endhint %}

### TData Import (via Converter)

For TData folders, you can also use the [Converter](/mvs-docs/modules/converter.md) module:

1. Place your TData folders in the `data/TDATA/` directory inside the MVS Web folder
2. Each folder should contain a `tdata/` subfolder with the session data
3. Open the Converter module, select **TData -> Session** mode, and click Start

The converter will read the TData and create proper accounts in the database.

## Export

To export accounts for backup or use with other tools:

### How to Export

1. Go to the [Accounts](/mvs-docs/accounts/account-management.md) page
2. Select the accounts you want to export using checkboxes or the range selector
3. Click the **Export** button

### Supported Export Formats

| Format            | What You Get                                                                                                                                                       |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Session files** | Standard Telethon `.session` files. Compatible with any Telethon-based tool.                                                                                       |
| **TData**         | Telegram Desktop format. Can be loaded directly into Telegram Desktop. Created via the [Converter](/mvs-docs/modules/converter.md) module (Session -> TData mode). |

### TData Export (via Converter)

For full TData export with all metadata:

1. Select the accounts you want to export
2. Open the [Converter](/mvs-docs/modules/converter.md) module
3. Select **Session -> TData** mode
4. Click Start

The converter creates a folder in `data/TDATA/` for each account containing:

* `tdata/` folder (Telegram Desktop session)
* `.session` file (Telethon session)
* `.json` file (account metadata: app\_id, device, 2FA password, etc.)
* `password.txt` (2FA password, if the account has one)

{% hint style="info" %}
Exported accounts are tracked in the system. You can use the **Export Status** filter on the Accounts page to see which accounts have been exported and which have not.
{% endhint %}


---

# 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://mvs-3.gitbook.io/mvs-docs/accounts/import-export.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.