How to export Facebook Messenger data
Facebook Messenger holds years of conversations for most people - casual chats, serious discussions, group plans, business negotiations, and everything in between. When you need those conversations as records you can save, search, or share, Facebook's Download Your Information tool is the primary method. Here's how it works and what to expect.
Using Download Your Information
Facebook provides a self-service data download tool. You can access it through:
On desktop: Settings and Privacy > Settings > Your Facebook Information > Download Your Information.
On mobile: Settings and Privacy > Settings > Accounts Centre > Your Information and Permissions > Download Your Information.
The tool lets you select which categories of data to download. For Messenger conversations specifically, select "Messages" and deselect everything else unless you need it. This keeps the download size manageable and the processing time shorter.
You'll choose a date range (or "all time"), the format, and the media quality. For date range, select the period that covers the conversations you need. If you're not sure when something was said, err on the side of a wider range - you can filter later.
Facebook queues your request and notifies you when the download is ready, usually within a few hours. Large requests covering years of messages with high-quality media can take up to 48 hours.
HTML vs JSON format
Facebook offers two export formats, and the choice matters.
HTML produces a set of web pages you open in a browser. Each conversation gets its own page with messages displayed chronologically - sender name, timestamp, message text. Media (photos, videos, audio) are embedded or linked. This format is readable immediately. Open the file, scroll through the conversation, and it looks like a plain version of the chat.
HTML is the right choice when you need to read through conversations, share them with someone who isn't technical, or produce records a lawyer or mediator can review without special tools.
JSON produces structured data files - one per conversation - containing the same information in a machine-readable format. Each message is an object with fields for sender, timestamp, content, reactions, and attachments.
JSON is the right choice when you plan to analyze the data, import it into a tool, search across large volumes, or merge Messenger records with exports from other platforms. A tool like Receipts can ingest JSON exports and combine them with data from other messaging platforms for unified analysis.
What's included in the export
Messenger exports are thorough. Here's what you get:
Message content. The full text of every message in the selected conversations and date range. This includes messages you sent and messages you received.
Timestamps. Each message includes the date and time it was sent. Timestamps are in Unix format in JSON exports (convertible to readable dates) and in human-readable format in HTML exports.
Sender information. The name associated with the Facebook account that sent each message. Note that if someone has changed their name on Facebook since the conversation, the export uses their current name, not the name they had when the message was sent.
Reactions. Emoji reactions on messages, including who reacted and with what emoji.
Media files. Photos, videos, GIFs, audio messages, and stickers sent in the conversation. These are downloaded as separate files and referenced within the message data. Media quality depends on what you selected during the export request.
Shared links. URLs shared in the conversation appear as text. Preview cards and thumbnails are not preserved - just the link itself.
Group chat metadata. For group conversations, the export includes the group name, participant list, and events like members joining or leaving.
Call history. Records of voice and video calls made through Messenger, including timestamps and duration, though not the call content itself.
What's not included
Deleted messages. If you or the other person deleted messages from the conversation, they don't appear in the export. The export reflects the current state of the conversation.
Unsent messages. Facebook's "unsend" feature removes messages from both sides. Unsent messages are not included in exports.
Disappearing messages. If the conversation was set to disappearing message mode, expired messages are not included.
The other person's deleted content. You only get what's currently visible in the conversation from your account's perspective.
Navigating the exported data
A Messenger export for an active account can be large - hundreds of megabytes or several gigabytes if media is included. Here's how to work with it efficiently.
Start with the index file. Both HTML and JSON exports include an index or directory structure organized by conversation. The HTML export has a main page that links to each conversation. Look for a file called index.html or a folder called messages containing subfolders for each chat.
Conversation folders are named by participant. Each conversation gets a folder named after the other participant (for one-on-one chats) or the group name. Inside, you'll find the message files and a subfolder for media.
Large conversations may be split across files. If a conversation contains thousands of messages, the export may break it into multiple files (e.g., message_1.html, message_2.html). These are chronological - start with the highest number for the oldest messages.
Search within HTML files. Open the HTML file in a browser and use the browser's find function (Ctrl+F or Cmd+F) to search for specific words or phrases. This is surprisingly effective for locating specific exchanges within a long conversation.
For JSON files, use a JSON viewer. Raw JSON is hard to read in a text editor. Browser extensions like JSONView or standalone tools like jq make the data navigable.
Practical tips for preservation
Request exports periodically. If you have ongoing conversations that may become relevant, don't wait until you need the records. Export quarterly or whenever something significant happens. This protects against future deletions or account issues.
Save exports to multiple locations. Download the export file, then copy it to cloud storage and an external drive. If your Facebook account is compromised, suspended, or deleted, the export is your only copy.
Note what's missing. If you know messages were deleted - by you, by the other person, or through disappearing message settings - document that fact separately. A record that says "messages from [date range] were deleted by [party] before export" provides context that the export alone can't.
Pair exports with screenshots for key moments. The export gives you the full text record. Screenshots give you the visual context - profile photos, message bubbles, the "seen" indicator. For documentation that needs to be persuasive as well as complete, both together are stronger than either alone.