Daniel Okonkwo writes about phones and mobile apps for Appcyclopedia, working on a MacBook Pro, a Pixel 9 Pro and an iPhone 15.
- macOS
- Windows
Short answer
Install Telegram Desktop on a computer and sign in. Open the chat, click the … menu, choose Export chat history, pick the media types, a size limit, the format and the dates, then click Export.
The catch: Telegram built the export tool for Telegram Desktop. Looking for it on your phone is the usual reason people decide Telegram cannot export a chat at all.
Below: the steps in Telegram Desktop, what each setting in the export window controls, which chats the tool cannot reach, and how to check the result.
How to export a Telegram chat with its media, from Telegram Desktop
To export a Telegram chat with its media, you need Telegram Desktop on a computer. The first group gets you to the export window, the second sets what goes into the archive, and the third runs it and checks what came out.
-
Get to the export window
Install Telegram Desktop and sign in
Telegram’s announcement of the export tool tells you to install the latest Telegram Desktop on your computer. Sign in with your phone number. The Telegram FAQ says cloud chats sync instantly across devices, so the chat you want is there.
-
Open the chat and choose Export chat history
Open the conversation, click the … menu at the top right, then Export chat history. For a single topic in a group with topics, the menu offers Export topic history instead. The export settings window opens.
-
Choose what goes into the archive
Tick the media types you want
Under Media export settings, tick what to include: Photos, Videos, Voice messages, Video messages, Stickers, GIFs and Files. Leave out the types you do not need, because every item you include has to be downloaded to your computer.
-
Set the size limit
Set Size limit to the largest single file you want saved. Telegram does not document how files over the limit appear in the archive, so if a particular large video matters, raise the limit rather than assume it is kept.
-
Pick HTML to read it, JSON to process it
Under Location and format, click the format and choose Human-readable HTML, Machine-readable JSON or Both. The announcement describes the HTML as beautifully formatted. JSON is for loading into another tool. Change Download path here if you want the folder somewhere particular.
-
Limit the dates if you need only part of it
The window shows From: and to:, set by default to the oldest message and present. Click either end to choose a date, or Reset to go back to the full range. A short range makes a long chat quicker to export and easier to search later.
-
Run the export and check it
Click Export and keep Telegram open
Click Export. The progress window says you can close that window, but not quit Telegram until the export is completed. Clicking Stop asks for confirmation and means starting over. Skip this file moves past one file that is holding things up.
-
Open the result and look at the oldest messages
When it finishes, Telegram says Your data was successfully exported with the Total files and Total size. Click Show my data, open the HTML file in a browser, and scroll to the start of the range to check the dates you chose, then open a few photos.
A common case: you need the last year of a busy family group, with photos, for somebody who is not on Telegram. Steps 1 and 2, then photos only in step 3, HTML in step 5 and a one-year range in step 6, give you a folder you can zip and send.
Every setting in the window cuts download time, so choosing them before clicking Export is what keeps a large chat manageable.

More about Telegram
A cloud-based messenger for chats, large groups, channels and files up to 2 GB.
If it goes wrong
- Export chat history is not in the menu
You are probably in a phone app. The tool is documented for Telegram Desktop. It also cannot reach a secret chat, which exists only on the device where it started.
- Telegram says you can begin downloading your data in a number of hours
Telegram Desktop shows this security delay on some export requests and notifies your other devices. Come back at the time it gives and repeat the request from the same computer. Telegram does not say which exports trigger it.
- The export is taking hours
Media is downloading. Stop it, then start again with fewer media types, a lower Size limit or a shorter date range. Stopping means starting over.
Why the export has to download everything again
Telegram keeps your cloud chats on its servers, which is why a chat you started on your phone appears on a new computer the moment you sign in. The export tool builds its archive from that cloud copy.
Telegram’s 2018 announcement says the tool saves chats, including photos and other media, so they are accessible offline in JSON or formatted HTML. It also says the tool is useful for people with millions of messages, who cannot easily reach the oldest parts of their history.
An offline copy means every photo and video you include is downloaded to your computer during the export, so the media you tick decides most of the work.
The choices in the export window are the only way to control the size, so make them before you click Export.
What each export setting controls
| Setting in the window | Choices shown |
|---|---|
| Media export settings | Photos, Videos, Voice messages, Video messages, Stickers, GIFs, Files |
| Size limit | A maximum size per file |
| Location and format | Human-readable HTML, Machine-readable JSON, or Both, plus Download path |
| From and to | A start and end date, from the oldest message to present |
The labels come from Telegram Desktop’s published interface text, and the formats match Telegram’s export announcement.
Start with the media types, then the size limit. Telegram publishes no figures for how large an export gets, so the folder size shown at the end is the first real number you will see.
When it is a secret chat, or the whole account
A secret chat looks like an ordinary conversation, and it is the one chat the tool cannot export from the cloud. The Telegram FAQ says secret chats are not part of the Telegram cloud, can only be accessed on their device of origin, and are lost if you log out of that device. Telegram does not describe any export for them.
Exporting everything is a different job. Telegram Desktop has Export Telegram data under Settings, Advanced, which covers your account information, contacts and chats by type. Telegram’s own interface points people to it before deleting an account.
If you are moving the other way, from WhatsApp into Telegram, the export is done in WhatsApp. Telegram’s post on moving chat history explains the import, and the guide to exporting a WhatsApp chat covers the first half.
How to keep exports small next time
- Export by date range, a year at a time, rather than the whole history in one go.
- Tick only the media you will open again. A text record needs none.
- Keep the Size limit low unless you know a large file matters.
- Choose HTML unless another program needs the data. It opens in any browser.
Use the desktop app for the export
A Telegram export is a short job once you are in the right app. On a phone there is nothing to find, and on a computer it is one menu away from any chat.
Install Telegram Desktop, open the chat, and set the media, size and dates before you press Export.
Then keep the folder somewhere backed up. The export is a copy that you look after yourself, outside Telegram.
Common questions
- Can I export a Telegram chat on my phone?
- Telegram documents the chat export tool for Telegram Desktop only. Install it on a computer, sign in, and your phone chats are there to export.
- Can I export a secret chat?
- Not with this tool. Telegram says secret chats are not part of the Telegram cloud and can only be accessed on the device where they started.
- Can I import the export back into Telegram?
- Telegram does not document that. Its import feature brings chats in from other apps such as WhatsApp, Line and KakaoTalk.
- What is the difference between HTML and JSON?
- HTML is a human-readable archive you open in a browser. JSON is machine-readable, for loading into another program. Choosing Both gives you the two.
Share this guide
Link copied
Was this guide helpful?
What was missing?
Thanks, that helps us.
Test log
Followed the steps? Tell us how it went on your device. Entries appear here after we check them.
- Worked Every step, start to finish · Elias Brandt and Daniel Okonkwo Team
I tested this
Steps performed and confirmed 14 days ago
When you need this
If you want one Telegram conversation kept outside the app, export it from Telegram Desktop. The phone apps have no export option, which is why people looking for it there come up empty.
- Describes
- Telegram Desktop for Windows and macOS, as documented on the Telegram blog and in its published interface text, November 2026
- Takes
- Five minutes to set up, then as long as the media takes to download
- Platforms
- macOS · Windows
- Published
- 4 November 2026
- Facts checked
- 3 November 2026
Steps repeated and verified by
Elias Brandt and
Daniel Okonkwo
on
- Elias Brandt: the Windows steps on a ThinkPad X1 Carbon (Windows 11 Pro).
- Daniel Okonkwo: the Mac steps on a MacBook Pro (macOS 27.0.1).