What is Telegram Tdata and how to use it? A complete guide
You bought 50 Telegram accounts, unzipped a folder called tdata, and now you are staring at files named key_datas and settingss. What do you do with them?
The tdata folder is the heart of every Telegram Desktop session. It holds your encrypted login keys, cached chats, and configuration. Copy it to the right place and your account opens without a phone number or SMS. This guide explains how tdata works, how to use it, and where the risks are.
"Telegram Desktop stores all local configuration, local cache, and active session keys in a dedicated folder called 'tdata'. Having access to this folder is equivalent to being logged into the active session." — Telegram Tech Support Reference.
If you work with Telegram marketing, automated messaging, parsing, or multi-account management, knowing the Tdata format is essential. All major Telegram automation tools (Telegram Prime, Telethon, Pyrogram) authenticate accounts using either Tdata or .session files. This guide explains what Tdata is, how to run it with Telegram Portable, and how to keep accounts alive long-term.
What is Telegram Tdata?
The tdata folder is the directory where Telegram Desktop (Windows, macOS, Linux) stores encrypted session tokens, application settings, and local cache. Copying this folder to another machine opens the account without a phone number or SMS code, because the authorization tokens are already inside.
- Session tokens — the cryptographic keys that prove the account is logged in.
- Application cache — chats, images, settings, and contact data stored locally.
- Encrypted configuration files —
key_datas,settingss, and numbered subfolders with encrypted state.
Why professionals buy Tdata accounts
The main practical reason is that Tdata accounts do not require a SIM card. The session is already authenticated and packaged in a folder. You can run hundreds of separate Telegram clients on one machine by placing each Telegram.exe next to its own tdata folder. Most Telegram marketing tools, parsers, and invite bots load accounts directly in Tdata format.
How to use Telegram Tdata accounts (step-by-step)
You must use the portable version of Telegram Desktop. The standard Windows installer (.msi) stores data in AppData and will not read a local tdata folder.
- Download the portable client. Visit desktop.telegram.org and download the portable version — a ZIP archive, not the installer.
- Create a dedicated folder. Make a new directory, for example
Telegram_Account_01. - Extract Telegram.exe. Place it inside the new folder.
- Place the tdata folder. Paste your tdata folder next to
Telegram.exe. The structure should look like this:Telegram_Account_01/ ├── Telegram.exe └── tdata/ (folder containing encrypted configuration files) - Launch Telegram. Double-click
Telegram.exe. The client opens directly into the account with no phone number prompt.
Troubleshooting common Tdata issues
- Phone number prompt on launch: The session has expired or been terminated by Telegram. Buy accounts from reliable providers to reduce dead-on-arrival rates.
- Blank screen or crash: The Telegram.exe version does not match the version used when the tdata was created. Download a portable build that matches the account's tdata version.
Converting Tdata to Session+Json
If your automation scripts require the .session SQLite format instead of Tdata, open-source Python libraries like opentele can load a tdata folder and export it as a Pyrogram or Telethon session. On accs.tg, accounts are sold in both formats so you can order the format your software requires directly.
Safety and anti-ban rules for Tdata accounts
IP mismatch at first login is the leading cause of instant bans on new Tdata accounts. Use a proxy that matches the account's registration country, and let the account sit idle for 24-48 hours before starting any automation.
| Rule | Description | Recommendation |
|---|---|---|
| Match proxy GEO | The proxy location must match the registration country of the Tdata account. | Use SOCKS5 mobile or residential proxies. |
| Warm up (resting) | Leave the account idle before starting automation or sending messages. | Wait 24-48 hours after the first login. |
| Two-step verification | Lock the account so that no third party can access it after purchase. | Set your own 2FA password in Settings immediately. |
Where to buy Telegram Tdata accounts
On accs.tg, Tdata and Session+Json accounts are available for multiple GEOs including USA, UK, Ukraine, Russia, and others. Accounts arrive within seconds of payment, registered on clean IP pools using real devices. Proxies and configuration help are available in the dashboard if you need them.
Each account comes as a ready-to-use tdata folder with matching metadata.
Browse the catalog at accs.tg/services or use the API to automate bulk orders. If you prefer the API-based format, read the Session+Json guide instead.