Skip to content
Telegram Backup

Export guide

How to Export Telegram Chat History with Telegram Desktop

By the Telegram Backup editorsUpdated 4 min read

The short answer

You export Telegram chat history in Telegram Desktop (opens in a new tab). For one conversation, open it, click ⋮ and choose Export chat history. For everything, go to Settings › Advanced › Export Telegram data. You pick the chats, media types, date range and format (HTML, JSON or both), and the archive is saved to your computer. Secret Chats are never included.

What are the two ways to export from Telegram?

Telegram Desktop offers two export entry points that produce the same kind of archive. Which one you use depends on scope.

Single-chat export versus full data export in Telegram Desktop.
FeatureSingle chat exportFull data export
WhereOpen the chat › ⋮ menu › Export chat historySettings › Advanced › Export Telegram data
CoversOne conversation, group or channelAny combination of chats, contacts and account data
Good forKeeping a record of one important threadAn account-wide archive before a big change
Includes account dataNoOptional: profile, contacts, sessions, other data
Single-chat export versus full data export in Telegram Desktop.

How do I export all my Telegram data, step by step?

  1. Step 1: Use an up-to-date Telegram Desktop

    Install or update it from desktop.telegram.org (opens in a new tab). Other Telegram apps, including Telegram Web, don’t necessarily offer the same full export, so use Telegram Desktop for this.

  2. Step 2: Open Settings › Advanced

    Scroll to the bottom of the Advanced section and choose Export Telegram data.

  3. Step 3: Select chat types

    Choose from personal chats, bot chats, private groups, private channels, public groups and public channels. For groups you can export only your own messages, which keeps archives smaller and limits how much of other people’s content you hold.

  4. Step 4: Select media

    Photos, videos, voice messages, round video messages, stickers, GIFs and files can each be switched on or off. Set a per-file size limit to skip very large videos.

  5. Step 5: Include account information if you want it

    Profile information, your contact list, the list of active sessions and miscellaneous data can be added. The contact list is useful later if you need to find people again.

  6. Step 6: Choose location, format and time period

    Pick a download folder, a format (HTML, JSON or both) and, optionally, a date range. Then start the export.

  7. Step 7: Approve the request if Telegram asks

    For security, Telegram can ask you to confirm the export from another logged-in device, and may delay it before the download can begin. Keep Telegram Desktop open until the export finishes.

  8. Step 8: Check the result

    Open the folder, check that the chats you care about are there, and spot-check that media opened correctly. Then move the archive to secure storage.

Should I choose HTML or JSON?

HTML
A set of linked web pages that look much like the chat itself. Open the main file in any browser to read. Best if a person is going to read the archive.
JSON
A single structured data file (plus media folders) that scripts and search tools can process. Best for searching years of messages or moving the data into another tool you trust.

If you aren’t sure, choose both. The media files are shared, so the extra size is mostly text.

What doesn’t a Telegram export include?

  • Secret Chats. They are end-to-end encrypted, stored only on the device that started them, and not available to Telegram Desktop.
  • Messages that were deleted before you exported. Telegram says deleted messages leave no trace on its servers.
  • Your access to private groups. The archive shows the group’s history but gives you no way to rejoin it.
  • Anything you left unticked, including media above your size limit.
  • An account you can restore. The archive is a copy to read. It is not a restore point.

How long does a Telegram export take?

It depends mostly on media. A text-only export of a modest account can finish in minutes. Years of photos and videos can take hours and tens of gigabytes. Exporting text first, then media in a second pass, makes a stalled export less painful.

How should I store an exported Telegram archive?

Treat it as one of the most sensitive files you own. It may contain years of private conversations, other people’s messages and photos, and your contact list.

  • Keep it on an encrypted disk or inside a password-protected encrypted archive.
  • Keep one copy offline, for example on an encrypted external drive, and know where it is.
  • Don’t upload it unencrypted to shared cloud folders.
  • Delete old exports you have replaced, and remember they include other people’s messages too.

An export is one layer of preparation, not the whole plan. See Telegram backup vs export for the other layers.

Frequently asked questions

Can I export Telegram chats on iPhone or Android?

The full export tool is in Telegram Desktop on a computer. Phones keep cloud chats in sync but don’t offer the same account-wide export. If you only have a phone, you can forward key messages to Saved Messages or save individual files, then export properly when you can use a computer.

Can I export a group chat I’m only a member of?

Yes. Telegram Desktop can export groups and channels you belong to, as far as you can see their history. For groups you can limit the export to your own messages. Think about the other members before you keep or share an archive of their messages.

Why does Telegram make me wait before exporting?

Exports contain your whole history, so Telegram adds friction for requests that might come from a stolen session. It can ask you to confirm on another device and delay the download. Waiting is normal, and it protects the account owner.

Can I open a Telegram JSON export in Telegram again?

No. Telegram has no documented feature for importing a Telegram export into an account. You can read HTML exports in a browser and process JSON exports with tools you trust.

Sources and references

  1. Chat Export Tool, Better Notifications and More (August 2018)Telegram blog(opens in a new tab)
  2. Telegram Desktop downloadTelegram(opens in a new tab)
  3. Telegram FAQ (cloud chats, Secret Chats, 2-Step Verification, your account)Telegram(opens in a new tab)
  4. Moving Chat History from Other Apps (January 2021)Telegram blog(opens in a new tab)

About this guide. Written and maintained by the Telegram Backup editors. First published , last reviewed . Telegram facts are checked against the sources above, and menu names can differ slightly between app versions. See our editorial policy.