Export Telegram Chat History: Step-by-Step Guide for Beginners

Telegram’s built-in export tool lets you download your entire chat history — messages, photos, videos, files, and voice notes — to your computer in a format you can read offline or archive permanently. As of 2026, the feature is fully functional on Telegram Desktop for Windows, macOS, and Linux, but it is not available on the Telegram mobile app (iOS or Android). If you’re on a phone, see the mobile workarounds section below.

There are two ways to export: pull out a single conversation, or dump everything at once. Both methods go through the Telegram Desktop app.

What You Need Before You Start

• Telegram Desktop installed on your computer (Windows, macOS, or Linux). Download from telegram.org.
• Your Telegram account logged in. If you just logged in for the first time, you may need to wait up to 24 hours — or confirm the export request from another linked device — before the export option becomes active. This is an anti-abuse delay Telegram enforces.
• Enough disk space. A chat with years of photos and videos can run into gigabytes.

Method 1: Export a Single Chat

Use this when you only need one conversation — a business chat, a legal record, or messages with a specific contact.

Step 1: Open Telegram Desktop and navigate to the chat you want to export.

Step 2: Click the three-dot menu (⋮) in the upper-right corner of the chat window.

Step 3: Select Export Chat History from the dropdown.

Step 4: A settings window opens. Choose which content to include: Photos, Videos, Voice messages, Video messages, Stickers, GIFs, Files, Forwarded messages. Uncheck anything you don’t need to keep the file size manageable.

Step 5: Set the size limit per file using the slider. If you choose a small limit (e.g., 500 MB), Telegram will split large exports into multiple files.

Step 6: Choose your format — HTML or JSON (explained in detail below).

Step 7: Choose a download path (where the files will save on your computer).

Step 8: Click Export. Telegram will show a progress bar and open the export folder automatically when it’s done.

Method 2: Export All Your Telegram Data

Use this for a full account backup — every chat, channel, and group at once.

Step 1: Open Telegram Desktop.

Step 2: Click the hamburger menu (☰) in the top-left corner.

Step 3: Go to Settings.

Step 4: Scroll down and click Advanced.

Step 5: Click Export Telegram Data.

Step 6: Select what to include. You can toggle: Account information (your profile, bio, contacts), Personal chats, Bot chats, Private groups, Public groups, My channels, Private channels, Photos, videos, voice messages, and files.

Step 7: Set the size limit and choose HTML or JSON format.

Step 8: Set the download path.

Step 9: Click Export. For large accounts, this can take several minutes or longer depending on how much media you’re pulling.

HTML vs. JSON: Which Format Should You Choose?

This is the most important decision in the export process. Here’s what each format actually means for you:

Format	Best For	How to Open
HTML	Humans — easy to read in any browser	Double-click messages.html in any browser
JSON	Developers, analysis, scripts, data processing	Text editor, Python, spreadsheet tools

Choose HTML if: You want to read your chat history like a webpage, share it with someone non-technical, or submit it as a legal record. The HTML export includes timestamps, linked media thumbnails, and proper formatting. Everything is readable without any technical knowledge.

Choose JSON if: You’re a developer, researcher, or analyst who wants to parse messages programmatically — search for keywords across years of chats, count message frequency, or import the data into a spreadsheet or database. JSON is also the right choice if you’re uploading to BigQuery or another data tool.

One important note about HTML exports: When you open the exported HTML file locally in Chrome, images and media may not load because Chrome blocks local JavaScript from reading file:// URLs by default. To fix this, either launch Chrome with the --allow-file-access-from-files flag, or serve the folder using a local server (python -m http.server in the export folder, then open localhost:8000).

How to Open and Read Your Exported Files

After the export finishes, Telegram opens the folder automatically. Inside you’ll find:

• messages.html — the main file if you chose HTML. Open it in any browser.
• result.json — the main file if you chose JSON. Open in a text editor or process with Python.
• photos/, files/, voice_messages/ folders — your media, organized by type.

For HTML exports, the file is self-contained and fully navigable. For JSON, a simple Python script can parse the data and count your messages or search for specific keywords.

Exporting Telegram Chat on Mobile (Workarounds)

Telegram’s official export tool only runs on desktop. If you’re primarily a mobile user, here are your options as of 2026:

Option 1 — Use Saved Messages as a bridge: Long-press the first message you want to save, tap the checkbox to select multiple messages, then tap the forward arrow and choose Saved Messages. You can do this for up to a few hundred messages at a time. It’s tedious for large archives but works without a computer.

Option 2 — Install Telegram Desktop temporarily: Even if you don’t use it day-to-day, installing Telegram Desktop on any computer just to run the export is the most complete solution. It syncs automatically — no manual transfer required.

Option 3 — Third-party tools: Browser extensions like “Save Telegram Chat History” for Chrome can archive conversations in PDF or plain text format. These work without the desktop app but are limited in scope and not officially supported by Telegram.

Troubleshooting Common Export Problems

“Export Chat History” Option Is Missing from the Menu

This happens in two situations: (1) you’re using the Telegram web version instead of the desktop app — the web version doesn’t support export. Switch to Telegram Desktop. (2) You just logged in and haven’t waited the 24-hour delay. Confirm the login from another device to skip the wait.

Export Crashes or Stops Mid-Way

Chats with several gigabytes of videos frequently cause Telegram Desktop to crash during export. Fix: go back into Export Chat History, uncheck Videos, export once to get everything else, then run a second export for videos only. This avoids the memory issue that causes crashes.

Some Old Messages Are Missing from the Export

This is a known bug affecting some group chats, particularly very old groups. The JSON export tends to be more complete than HTML for affected chats — try switching formats if messages appear missing.

Export Works But Media Won’t Open

Check that your file size limit wasn’t set too low. If the size limit cut off a video halfway, it won’t be playable. Re-export with a higher size limit or no limit set.

Linux: Export Folder Not Created

A reported issue on some Linux systems where the ChatExport folder simply doesn’t appear. Workaround: manually specify the download path to a folder you know exists (e.g., your home directory) instead of letting Telegram choose the default location.

Groups with Topics Don’t Show the Export Option

This is a confirmed bug in Telegram Desktop for groups that use the Topics feature. The three-dot menu doesn’t display “Export Chat History” for these groups. As of early 2026, no fix has been shipped. The workaround is to use the full account export via Settings → Advanced → Export Telegram Data, which captures all groups including topic-based ones.

Tips for Managing Large Exports

Export in segments if your archive is very large — Telegram doesn’t support date-range filtering natively, but excluding large media types and exporting them separately keeps file sizes manageable. If you regularly need to search through years of messages, keep a JSON copy alongside your HTML export — JSON is much faster to search with scripts.

Re-export periodically since Telegram exports are a snapshot in time, not a live sync. For ongoing archiving, set a reminder to export every few months. Store exports on an encrypted external drive or cloud storage (Dropbox, Google Drive) so your archive remains accessible without relying on Telegram’s servers.