How to Fix Telegram “Export Chat History” Missing (And Export Your Chats)

If you opened the menu in a Telegram chat expecting to see “Export Chat History” and it isn’t there, you haven’t done anything wrong — you’re almost certainly running the wrong Telegram client. As of 2026, the export feature only exists in one specific desktop build of Telegram, and three of the most common ways people use Telegram on a computer (Telegram Web, the native macOS Telegram app from the App Store, and any mobile app) don’t expose it at all. This guide explains why the option is missing for most people, exactly which app you need, and how to use it once you have it.

Why you can’t see “Export Chat History”

Before walking through the export itself, it’s worth fixing the assumption that trips up most readers. Telegram ships several different clients that all look like “Telegram” — and only one of them can export.

Where you’re using Telegram	Export available?
Telegram Web (web.telegram.org)	❌ No
Telegram for iOS (iPhone/iPad)	❌ No
Telegram for Android	❌ No (export only on tablets with desktop layout)
Telegram for macOS — native app (from App Store)	❌ No
Telegram Desktop (Windows/Linux from telegram.org)	✅ Yes
Telegram Lite for macOS (from App Store or telegram.org)	✅ Yes

If you’re on a Mac and downloaded the standard Telegram app from the App Store, you have the wrong client. The native macOS app and Telegram Lite are two separate listings — Telegram Lite is the cross-platform desktop client and the one that includes the export tool. Install it alongside your existing app; both will sync to the same account.

What “Export Chat History” actually does

The export tool saves a snapshot of your messages, photos, videos, voice notes, files, and stickers to your computer in either HTML (human-readable in a browser) or JSON (machine-readable for scripts and analysis). It’s a one-way local backup — Telegram already stores your chats in its cloud, so this is only for keeping a copy outside Telegram’s servers.

You can export one chat at a time, or dump your entire account in a single archive. Both routes live inside Telegram Desktop (Windows/Linux) or Telegram Lite (macOS).

Method 1: Install the correct Telegram client

If your current app doesn’t show the export option, the fix is to install the right one. This takes about two minutes.

Step 1: Download Telegram Desktop or Telegram Lite. Go to telegram.org/apps and pick the build for your operating system. Windows and Linux users want Telegram Desktop. macOS users want Telegram Lite specifically — the page lists it as “Telegram for macOS” but the App Store name is Telegram Lite.

Step 2: Sign in with your phone number. You’ll get a confirmation code in your existing Telegram app. Approve it. Your chats sync immediately because they live in Telegram’s cloud.

Step 3: Wait out the 24-hour delay if it appears. Telegram blocks brand-new sessions from exporting data for up to 24 hours as an anti-abuse measure. You can skip the wait by confirming the export request from another already-logged-in device when it pops up.

Method 2: Export a single chat

Use this when you only need one conversation — a business chat, a contact you’re about to lose access to, a legal record.

Step 1: Open the chat in Telegram Desktop or Telegram Lite.

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

Step 3: Select “Export Chat History.” If the option isn’t there, you’re still in the wrong client (see Method 1) or the chat is a group with the Topics feature enabled (see the troubleshooting section).

Step 4: Choose what to include. Uncheck anything you don’t need — videos and photos balloon export size fast. Each unchecked category cuts the export down by gigabytes if the chat is media-heavy.

Step 5: Set a size limit per file. A lower limit (e.g., 500 MB) splits large exports across multiple files. Useful if you’re worried about Telegram running out of memory mid-export.

Step 6: Pick HTML or JSON. Pick HTML if you want to read it in a browser. Pick JSON if you’ll process it with a script, search across messages, or import into a spreadsheet.

Step 7: Choose a download folder, then click Export. A progress bar appears and the folder opens automatically when finished.

Method 3: Export your entire Telegram account

Use this when you want a full backup of every chat, channel, and group at once.

Step 1: In Telegram Desktop or Telegram Lite, click the hamburger menu (☰) in the top-left.

Step 2: Go to Settings → Advanced → Export Telegram Data.

Step 3: Toggle which categories to include. You can pick account info (profile, bio, contacts), personal chats, bot chats, private groups, public groups, channels, and media types. For a full backup, leave everything checked.

Step 4: Set the file size limit and pick HTML or JSON.

Step 5: Choose a download path and click Export. Large accounts (tens of thousands of messages, gigabytes of media) can take from several minutes to an hour or more. Don’t close the window — Telegram doesn’t resume interrupted exports cleanly.

HTML vs. JSON: pick the right format

Format	Best for	How you’ll open it
HTML	Reading messages back, sharing with someone non-technical, legal records	Double-click messages.html in any browser
JSON	Searching, scripting, spreadsheet import, BigQuery, analysis	Text editor, Python, jq, Excel

Pick HTML if you want it to look and read like a chat. The HTML export includes timestamps, thumbnails of linked media, and proper formatting — no technical knowledge needed.

Pick JSON if you’re a developer, researcher, journalist, or analyst who wants to search messages programmatically, count message frequency, or import the data somewhere else. JSON is also the better choice for very large archives because it’s faster to grep than HTML.

One quirk with HTML exports: if you open the file locally in Chrome, images may not load because Chrome blocks JavaScript from reading file:// URLs. Fixes: launch Chrome with --allow-file-access-from-files, or cd into the export folder and run python -m http.server, then open localhost:8000 in your browser. Firefox and Safari don’t have this restriction.

What you’ll find in the export folder

After the export finishes, Telegram opens the folder automatically. You’ll see:

• messages.html — main file if you chose HTML
• result.json — main file if you chose JSON
• photos/, files/, voice_messages/, video_files/ — your media, organized by type

For HTML exports, the file is self-contained and fully navigable through paginated chunks. For JSON, a simple Python script can parse result.json and search for keywords, count messages, or filter by date.

Mobile workarounds (iOS and Android)

The official export tool doesn’t run on phones. If you’re stuck on mobile, here are your real options.

Option 1 — Install Telegram Desktop or Telegram Lite on any computer. Even if you don’t normally use a computer for Telegram, installing the desktop client just to run the export is the most complete and reliable solution. It syncs automatically from the cloud — no transfer needed from your phone.

Option 2 — Save individual messages to iCloud or Files. On iOS, tap a message, hit Forward, then choose Save to Files. This works for one message or a small batch but is tedious past a hundred messages. On Android, long-press a message, select multiple, then share to Google Drive or any file manager.

Option 3 — Forward messages to Saved Messages. Long-press the first message you want to keep, tap the checkboxes for additional messages, then forward them all to Saved Messages. This pins them in a special chat that’s always accessible across devices but doesn’t pull them off Telegram’s servers.

Option 4 — Third-party scripts via the Telegram API. Tools like tg-archive and telegram-download-chat on GitHub use the Telegram API (with your own api_id and api_hash from my.telegram.org) to pull chat history directly. These work without the desktop app at all but require some command-line comfort.

Troubleshooting common export problems

“Export Chat History” option is missing from the menu

Three causes, in order of likelihood:

1. You’re using Telegram Web, the native macOS Telegram app, or a mobile app. None of these support export. Switch to Telegram Desktop on Windows/Linux or Telegram Lite on macOS.
2. You just signed in and the 24-hour anti-abuse delay is active. Approve the export request from another logged-in device to skip the wait.
3. The chat is a group with the Topics feature enabled. This is a confirmed bug in Telegram Desktop — the three-dot menu doesn’t show “Export Chat History” for forum-mode groups. As of early 2026, no fix has shipped. Workaround: use the full account export via Settings → Advanced → Export Telegram Data, which captures topic-based groups along with everything else.

Export crashes or stops partway through

Chats with several gigabytes of videos regularly cause Telegram Desktop to run out of memory mid-export, especially on machines with under 16 GB of RAM. Fix: go back into Export Chat History, uncheck Videos, export the rest first, then run a second export for videos only with a lower per-file size limit (e.g., 500 MB).

Empirically, the desktop client tops out at around 30 million messages in a single export on a 32 GB RAM machine. Past that, you’ll need to script the export with the Telegram API directly or break the chat into segments.

Some old messages are missing from the export

This is a known bug affecting some very old group chats (creation dates around 2018 or earlier) where messages appear in the app but vanish from the HTML export. The JSON export tends to be more complete for these chats. Try switching format and re-exporting. If JSON also misses messages, the data is likely missing from the chat itself on Telegram’s servers, not the export.

Export finishes but media won’t open

Check that the size limit wasn’t set too low. If a 700 MB video got cut at the 500 MB ceiling, the file is corrupt and won’t play. Re-export with a higher limit or “No limit” selected.

Linux: export folder isn’t created

Confirmed issue on some Linux distributions where the default ChatExport folder simply doesn’t appear. Workaround: in the export dialog, manually set the download path to a folder you know exists (your home directory or ~/Downloads) instead of letting Telegram choose.

Groups with topics don’t show the export option

Covered above under “missing menu option” — this is a real bug, not user error. Use the full account export as the workaround.

Export gets stuck at “Preparing data”

Telegram caches recent messages locally but lazy-loads older ones. If your export stalls before any progress shows, scroll up inside the chat itself for 30 seconds or so to force the client to backfill older messages from the server, then reopen the export dialog.

Tips for managing large exports

Telegram doesn’t support date-range filtering in the export dialog, 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 grep with scripts and jq.

Exports are snapshots, not live syncs. If you need an ongoing archive of an active chat, run the export every few months on a calendar reminder, or look at tools like tg-archive that periodically sync new messages to a local SQLite database.

Store completed exports on an encrypted external drive or in encrypted cloud storage. The export files themselves are unencrypted plain HTML, JSON, and raw media — anyone with access to the folder can read your entire chat history. Treat them like any sensitive file.

Quick reference: which method do I need?

What you’re trying to do	Which method
Save one specific chat for records	Method 2 (single chat export)
Back up your whole account before deleting it	Method 3 (full account export)
Export from your iPhone or Android phone	Mobile workarounds — install Telegram Desktop on a computer
Export a group that uses Topics	Method 3 (single chat export doesn’t work for these)
Don’t see the export option at all	Method 1 — install Telegram Desktop / Telegram Lite
Search messages programmatically	Method 2 or 3 with JSON format

When to use third-party export tools instead

The built-in export is enough for most users, but it has real limits: no date-range filter, no incremental sync, no automatic re-export. If you’re archiving a chat for compliance, journalism, or research and you need ongoing capture, consider:

• tg-archive (open source) — syncs a Telegram group to a local SQLite database and generates a static archive site. Best for public groups and channels you want to mirror.
• telegram-download-chat (open source) — command-line tool that uses the Telegram API to download full chat history with more granular options than the official export.
• Telegram Bot API mirroring — set up a bot that forwards messages to a private channel you control. Useful for real-time capture but only works for chats the bot can join.

All of these require your own Telegram API credentials, which you can generate at my.telegram.org. They’re not officially supported by Telegram but they don’t violate the Terms of Service for personal use.

As of 2026, the official export tool is still the right starting point for almost everyone — it just requires being in the right Telegram client first.