stackandink.com
← All notes

Export Telegram Chat History on Mac with Telegram Lite

Learn how to export one Telegram chat or all account data on a Mac with Telegram Lite, choose the available format, and handle Telegram’s 24-hour security wait.

  • macos
  • telegram
  • data-export
  • ai-agents
  • productivity

Updated

The quickest way to export Telegram chat history on a Mac is to use Telegram Lite, the Mac App Store edition of Telegram Desktop.

The native Telegram for macOS app may not show an export option. In Telegram Lite, you can export one conversation from its chat menu or export all account data from Settings → Advanced → Export Telegram Data.

Which Telegram app supports chat export on Mac?

Telegram offers two desktop clients for macOS:

  • Telegram for macOS is the native Mac application.
  • Telegram Desktop is the cross-platform client. Its Mac App Store edition is called Telegram Lite.

At the time of writing, the native client did not expose the chat export feature I needed. Telegram Lite did.

Telegram’s official applications page lists both clients. The Telegram Lite App Store listing identifies Telegram FZ-LLC as its developer and explicitly mentions data and chat export.

If you already have Telegram for macOS installed, you do not need to remove it. Telegram Lite can be installed separately for the export.

Export one Telegram chat

  1. Install Telegram Lite from the Mac App Store.
  2. Sign in to your Telegram account.
  3. Open the conversation you want to export.
  4. Open the chat’s three-dot menu.
  5. Select Export chat history.
  6. Choose which data and date range to include.
  7. Choose the destination directory and start the export.

Telegram Lite chat menu with Export chat history highlighted and a pointer cursor

Open the conversation menu and select Export chat history.

The export settings let you include or exclude items such as photos, videos, voice messages, files, stickers, and GIFs. Excluding large media files can make the export substantially smaller and faster.

Telegram Lite Chat export settings with Photos selected and other media options available

Choose the media types, file-size limit, and date range before starting the export.

The exact controls can depend on the export scope and client version. In the chat-level export I used, Telegram Lite did not display a JSON selector and created an HTML archive. The account-wide export described below did let me choose between HTML and JSON.

Telegram’s official export instructions describe the same chat-level export workflow.

Export all Telegram account data

To export more than one conversation:

  1. Open Settings in Telegram Lite.
  2. Select Advanced.
  3. Select Export Telegram Data.
  4. Choose the chats and data types to include.
  5. Select HTML or JSON and start the export.

A full account export may include personal chats, groups, channels, contacts, profile information, and media. Review the selected categories before starting instead of exporting everything by default.

Choose HTML or JSON for an account-wide export

When Telegram offers a format selector, choose based on what you plan to do with the archive.

Format Best for Trade-off
HTML Reading and browsing manually Harder to process programmatically
JSON Searching, scripting, statistics, or structured analysis Less convenient to read directly

HTML produces an archive that opens in a browser and is usually the best choice when you only want a readable copy.

JSON preserves the conversation as structured data. Choose it when you plan to process the export with software, jq, Python, or an AI-assisted workflow.

You can run separate exports if you need both formats.

If the export option is missing

There are three likely explanations.

You are using the native Telegram for macOS app

Check which client is open. If the chat menu does not contain Export chat history, install Telegram Lite or Telegram Desktop and try the same conversation there.

You opened the wrong menu

The export command for one conversation is inside that chat’s three-dot menu. The account-wide export is under Settings → Advanced → Export Telegram Data.

Telegram has applied a security delay

Telegram may restrict exports from a newly authorized desktop session. Its guidance says that you must either wait 24 hours or confirm the export request from another logged-in device.

In my case, I waited, and the export became available after the security window ended. Install and authorize Telegram Lite ahead of time if you need the archive by a deadline.

Telegram service notification confirming an accepted data export request while other chats are redacted

Telegram may send a service notification asking you to confirm the export or wait before trying again.

Keep the exported chat private

A Telegram export can contain other people’s messages, usernames, phone numbers, attachments, personal information, and secrets.

Treat the archive as sensitive data:

  • export only the conversations and date ranges you need;
  • exclude unnecessary media;
  • keep the archive outside a Git repository;
  • avoid placing it in an automatically synchronized directory;
  • do not upload the full archive to an external AI service; and
  • delete temporary and duplicate copies after finishing.

If you need to analyze the JSON, first create a minimized copy containing only the required fields and messages.

For a public, text-only archive, see how I analyzed a Telegram channel export with Codex without converting its HTML to JSON.

A follow-up article will cover a practical workflow for safely analyzing a Telegram JSON export locally.

Takeaway

Use Telegram Lite when the native Telegram for macOS application does not show an export command.

Export a single conversation from its three-dot menu or export account-wide data from Settings → Advanced. A chat-level export may create HTML without a format selector; an account-wide export can offer HTML for reading or JSON for structured processing. Allow for a possible 24-hour security delay, and handle the resulting files as sensitive data.