How to Export iMessage History
TL;DR
The best free option is **imessage-exporter**, an open-source tool that saves your iMessage history to HTML or TXT with attachments, reading either a Mac’s `chat.db` file or a local iPhone backup. Apple ships no export button, so the alternatives are printing a single thread to PDF from Messages, copying text out by hand, or a paid utility for the formats the free tool lacks (PDF across threads, CSV, legal discovery). Apple’s own "get a copy of your data" download does **not** include message content, because iMessage is end-to-end encrypted. Every one of these produces a snapshot that is out of date the next morning.
On this page
The short answer
There is no export button. Apple has never shipped one, on iPhone or on Mac, and after two decades of the Messages app that is clearly a decision rather than an omission.
What you have instead are four realistic routes, in rough order from free to paid:
- Run
imessage-exporter, a free, open-source tool that writes your whole history to HTML or TXT with attachments, reading either the Messages database on a Mac or a local iPhone backup. This is the best answer for most people and the one the affiliate listicles never mention. - Print a single conversation to PDF from Messages on a Mac. Native, built in, one thread at a time — the way to export imessage to pdf without any tool.
- Copy text out by hand into a document for a tiny job, and save attachments individually.
- Buy a paid utility only for a format the free tool does not produce — PDF across many threads at once, CSV, a spreadsheet, or a purpose-built legal-discovery package.
And one route that people expect to work and does not: requesting your data from Apple. More on that below, because it is the single most common wasted afternoon in this whole topic. And if what you actually want is for the history to stay current rather than freeze into a file, skip to the ongoing alternative at the end.
The free route: imessage-exporter
For most people asking how to download imessage history, the honest best answer is a free, open-source command-line tool: imessage-exporter by ReagentX (github.com/ReagentX/imessage-exporter), released under the GPL-3.0 license. It is the thing the affiliate roundups leave out, because there is no referral fee on free software.
On a Mac, install it with Homebrew — brew install imessage-exporter — or with Cargo if you already use Rust. It reads the live Messages database at ~/Library/Messages/chat.db, the ordinary SQLite file Messages already keeps on disk, and writes a full export to HTML or TXT with attachments saved alongside. It preserves the things a naive copy-paste loses: attachments, tapbacks and reactions, replies, edited-message history, and stickers, across SMS, MMS, RCS, and group chats. One run saves every conversation, so to save an imessage conversation — or all of them at once — is a single command, not four hundred manual operations.
No Mac? It also reads a local iPhone backup, which is how a Windows or Linux user can extract imessages from iphone: make an unencrypted backup of the phone to the computer, point the tool at that backup, and you get the same readable HTML or TXT out the other side.
The one thing it does not do is PDF. It exports HTML and TXT only. If you need a PDF, open the exported HTML in a browser and print it to PDF — the tool gives you the readable, attachment-complete export, and the browser handles the format conversion. For a single thread you can skip the tool entirely and print straight from Messages, covered next.
Printing a single conversation to PDF
This is the only genuinely native option — no tool to install — and for a single important thread it is often enough.
Open Messages on a Mac, select the conversation, and use File → Print. In the print dialog, choose Save as PDF instead of a printer. You get the conversation laid out the way it appears on screen, with sender names and timestamps preserved.
The limits are real. It works one conversation at a time, so an archive of 400 threads is 400 manual operations — which is exactly why imessage-exporter exists for the bulk case. Long conversations may need scrolling to load older messages before they will print. Attachments come through as inline previews rather than original files. And it only covers what is actually present on that Mac — if a thread predates the machine, or never synced to it, it is not there to print.
For "I need a clean PDF of this one conversation, today," it is the right tool. For anything archival, reach for the exporter above.
Copying text out by hand
You can select messages inside a thread, copy, and paste into a text editor or document. Attachments can be saved out of the thread individually.
This is the lowest-tech option and it has exactly the properties you would expect: perfect for pulling three messages into an email, useless for anything larger. Formatting, sender attribution, and timestamps degrade depending on where you paste, and there is no reliable way to keep the text and its attachments associated with each other afterwards.
On an iPhone there is even less available — you can forward selected messages to yourself or take screenshots, and that is broadly it. There is no built-in path from an iPhone directly to a readable file on a computer; that path runs through a Mac or a local backup, as above.
Apple’s data download does not include your messages
Worth stating clearly, because a lot of people go down this road first: requesting a copy of your data from Apple’s Data and Privacy portal does not give you your iMessage conversations.
iMessage is end-to-end encrypted, and Apple cannot read the contents, so there is nothing for it to hand back. The archive you receive contains things like sign-in records, purchase and app usage history, marketing and support history, and various account metadata — useful for a subject-access request, useless as a message archive. You may see capability-query logs, which record whether a number could receive an iMessage; those are not conversations and contain no message text.
The same logic applies to a warrant or a legal-hold request aimed at Apple. The content is not Apple’s to produce. If you need iMessage history for a dispute or a compliance matter, it has to come off the device — via the exporter or a paid utility, not from Apple.
Backups are not exports
A device backup — to iCloud, or a local backup made on a Mac or PC — will normally carry your messages forward to a new phone. That is a genuinely important thing to have, and if you have not checked recently, check.
A raw backup, on its own, is not an export. It is an opaque restore artifact, designed to be read by another Apple device, not by you. You cannot open it and read a conversation, search it, hand it to a colleague, or feed it into anything by itself. It answers "will I lose my messages," not "can I read my messages somewhere other than this phone."
But here is the nuance that matters: a local, unencrypted backup is exactly what imessage-exporter reads to produce a readable export — it is the no-Mac path from the free-route section above. So a backup is not an export, yet the right backup is the raw material an export tool turns into one. What still does not work is expecting the backup file itself to be human-readable, or expecting Apple’s data download to stand in for it.
One related trap: Messages in iCloud changes where the authoritative copy lives, so what is present on any given Mac depends on your sync settings and how long that machine has been signed in. Before assuming a thread is exportable, confirm it is actually visible in Messages on the machine you plan to export from.
Paid export utilities: when the free tool isn’t enough
The best-known iMessage export tool is free and open-source, so the paid desktop applications are a tier, not the whole category. You reach for one when you need something imessage-exporter does not do:
- PDF or CSV across many threads at once. The free tool leaves PDF to a browser print and does not emit CSV; a paid tool can produce both directly.
- A spreadsheet or database-ready format for loading messages into another system.
- Legal discovery. For a matter handed to a lawyer or an auditor, purpose-built discovery formats and chain-of-custody features are their own market.
- A graphical interface. If a command line is a non-starter, a GUI app that reads a Mac or a local backup and clicks through to an export can be worth paying for.
They all work either from a Mac where your messages are present, or from a local device backup you have made. Points to weigh before buying one:
- What it reads from. Working from a local backup and working from a live Mac are different products with different completeness.
- Attachment handling. Whether photos and files are exported as real files, correctly associated with the message they arrived on, or flattened into an image of the conversation.
- How participants are labeled. Threads carry phone numbers and email addresses; whether the tool resolves those to names varies, and it is the difference between a readable archive and a wall of digits.
- Trust. You are pointing a third-party application at the most personal data you own. Buy from someone who says clearly whether anything leaves your machine.
- Format fit. A folder of PDFs is an archive, not a record system. Nothing searches it, nothing links it to a customer, nothing tells you it exists in six months.
Why this is all so awkward
Step back and the shape of the problem is clear. Every route above — free tool included — produces the same thing: a snapshot, of some threads, in a format nothing else uses.
- It is frozen at the moment you ran it, so effort scales with how often you need it current.
- It is stale immediately — the export you made this morning is missing this afternoon’s messages.
- Text and attachments live as separate files, and unless the tool keeps them linked they often never find each other again.
- The output is a document, so it cannot be searched across, linked to a customer, or joined up with anything you said to the same person by email or on another messenger.
- Group threads have no clean representation across most formats.
Which means most people asking "how do I export my iMessage history" do not actually want a file. They want the history to be somewhere useful — attached to the person it belongs to, searchable, and still true next week. An export cannot be that, structurally.
A note on consent
Exporting a message history means making a durable copy of a conversation that other people were also part of, and they were not asked.
Sometimes that is entirely proper — your own business records, a matter under legal hold, a handover you are obliged to make. Sometimes it is not, and the difference is worth thirty seconds of thought before you run the command or click the button. A personal Messages archive contains far more than work: family, health, and years of private conversation with people who assumed it stayed on your phone. Export the threads you need, not the whole archive out of convenience. Be careful where the output goes, because a folder of HTML files or PDFs has none of the encryption the original conversation had. And if this is an employee’s account rather than your own, the decision belongs to them, with their knowledge — not to whoever administers the laptop.
The ongoing alternative
If the need is one-time — a legal matter, closing an account, handing over a thread — take the export and be done. Run imessage-exporter, print a thread to PDF, or buy a utility for the format you need.
If the need is ongoing, an export is the wrong shape, because every export above is a snapshot that is stale the next morning. What you want instead is for the history to keep arriving somewhere that treats it as a record rather than a document. That is what the Pantheon desktop app does: it reads local iMessage on your Mac and keeps it as a searchable record, per contact — and it does the same for Telegram and WhatsApp, so the same person is one profile no matter which app or which handle a message came from. Your iMessage history stops being a folder of files and becomes part of one searchable relationship record that does not go stale, because it does not stop.
Stage honesty: Pantheon is in alpha. Telegram is live today; WhatsApp and iMessage run through the desktop app on your Mac; mobile is incoming.
Frequently asked questions
Is there a free way to export iMessage?
Yes. imessage-exporter — an open-source, GPL-3.0 tool by ReagentX — is free and exports your whole history to HTML or TXT with attachments. Install it on a Mac with brew install imessage-exporter (or via Cargo) and it reads the Messages database at ~/Library/Messages/chat.db. It also reads a local iPhone backup, so you can export without a Mac. It does not produce PDF directly — for that, print the exported HTML from a browser.
Is there a way to export all my iMessages at once?
Yes, and for free. The open-source imessage-exporter writes every conversation in one pass — from a Mac’s message database or a local iPhone backup — to HTML or TXT with attachments. Apple’s built-in route (printing a conversation to PDF from Messages on a Mac) is only one thread at a time; a paid utility earns its price when you need PDF across many threads, CSV, or a legal-discovery format the free tool does not emit.
Can I get my iMessages from Apple by requesting my data?
No. iMessage is end-to-end encrypted and Apple cannot read the content, so the Data and Privacy download does not include your conversations. You get account records, sign-in and purchase history, and similar metadata — not messages. Message history has to come off your own device.
Can I export iMessage directly from an iPhone?
Not to a readable file from the phone itself — on an iPhone you can forward selected messages or take screenshots, and that is essentially the extent of it. But you can extract imessages from iphone through a computer: make a local, unencrypted backup and run imessage-exporter against it, or open the messages on a Mac where they are present and export from there.
Does an iCloud backup count as an export?
A backup is not a readable export — it is built to restore onto another Apple device, so you cannot open it and read a thread. The exception is a local, unencrypted backup: opaque on its own, but exactly what a tool like imessage-exporter reads to produce a readable HTML or TXT export. An iCloud-only backup gives an export tool nothing to point at.
What is the best format to export to?
It depends on the purpose. The free imessage-exporter gives you HTML (closest to how the conversation looked) or TXT. PDF is right for anything a human or a lawyer will read — print the exported HTML, or use a paid tool that emits PDF directly. CSV or JSON is right if the messages are going into another system. If the goal is an ongoing record rather than a one-time document, no export format is a good answer — a tool that keeps capturing the history is.
Related
What is an iMessage CRM?
An iMessage CRM is a system of record that ties your Apple Messages conversations to the people in them — one contact per person, the full thread history behind it, searchable. Almost no CRM offers it, because personal iMessage has no business API and its history lives on your Mac rather than in a cloud service a vendor can connect to. It is a different thing from Apple Messages for Business, which is Apple’s official branded-business channel.
Read →iMessage for Business: What It Actually Means
Two different things share this name. **Apple Messages for Business** is Apple’s official branded channel — you register your brand, connect an Apple-approved Messaging Service Provider, and customers message your company from Maps, Search, or Siri. **Personal iMessage used for business** is the far more common reality: operators closing real work from their own Apple Account, on their own number. The first has an application process. The second has no CRM coverage, which is the actual problem most people are searching for.
Read →iMessage CRM
Read →What is Apple Messages for Business?
Apple Messages for Business is a channel that lets customers start a conversation with a verified company directly in the Messages app on their Apple devices. There is no separate Apple business chat app and no direct Apple API for brands — a company registers its brand with Apple, connects an Apple-approved Messaging Service Provider (MSP), and that provider carries messages between Apple and the company’s systems.
Read →What is a Relationship Operating System (Relationship OS)?
A Relationship OS (relationship operating system) is software that treats your network of relationships as the core data layer of your work — consolidating messages, contacts, context, and history from every channel into one continuously updated record per person, rather than per deal or per ticket.
Read →Last updated