What is in a Snapchat data export, and how to read the chats

Updated November 20, 2026 · By ThreadTidy

You asked Snapchat for your data, and you got one or more files called mydata~….zip. Your chats are in there, but not as chats. They are one data file and one folder of media. This page explains what each part is.

What the download contains

Folder or fileWhat it is
json/chat_history.jsonEvery chat message Snapchat exported, grouped by friend or group
json/snap_history.jsonA log of snaps sent and received: who and when, no content
json/friends.json, json/account.jsonYour friends’ usernames and display names, and your own username
html/ and index.htmlSnapchat’s own pages for the same data
chat_media/The photos, videos and voice notes saved in chats, all in one folder
memories/Your saved Memories, if you asked for them

The json folder is only there if you turned on Export JSON Files when you requested the export. Without it, a tool has nothing reliable to read.

How chat_history.json is built

The file is one object. Each key is a conversation: a friend’s username for a one-to-one chat, or a long ID for a group. Each value is the list of messages.

json/chat_history.json
{
  "alice.w": [
    {
      "From": "alice.w",
      "Media Type": "MEDIA",
      "Created": "2024-03-14 15:31:00 UTC",
      "Content": "",
      "Conversation Title": null,
      "IsSender": false,
      "Created(microseconds)": 1710430260000,
      "IsSaved": true,
      "Media IDs": "b~EiQSFTM0SEdmSTFNRzBDdkhlelFQS1hLUhoAGgAyAXxIAlAEYAE"
    }
  ]
}
FieldWhat it means
FromUsername of the person who sent the message
IsSendertrue when you sent it
Media TypeTEXT, MEDIA (photo or video), NOTE (voice note), STICKER, SHARE, or a status line such as STATUSERASEDMESSAGE
CreatedDate and time in UTC
Created(microseconds)The same moment as a number. Despite the name, exports usually hold milliseconds here
ContentThe text. Empty for media
Conversation TitleThe name of a group chat. Empty for one-to-one chats
IsSavedWhether the message was saved in the chat
Media IDsThe IDs of the files sent with the message. Several IDs are separated by |

Messages are not guaranteed to be in order, so a reader has to sort them by time.

Why the media files have unreadable names

Every file in chat_media is named with a date and an ID:

chat_media/
2024-03-14_b~EiQSFTM0SEdmSTFNRzBDdkhlelFQS1hLUhoAGgAyAXxIAlAEYAE.jpg
2024-03-15_media~zip-38FDD84B-5891-4975-84BD-08763E785D32.mp4
2024-03-15_overlay~zip-31FBA148-B00D-4E1D-A802-25249ADDF1A8.png
2024-03-18_thumbnail~zip-C07EF7F5-9005-43FE-83C2-9CA9F173CA3E.jpg

Why only saved chats are in the export

Snapchat is built to delete chats. By default a message is removed from Snapchat’s servers after everyone has viewed it or after it expires. What stays is what someone saved: messages kept in the chat and media saved in chat.

The export can only contain what Snapchat still has. So:

How to request the export with chats and media

  1. Open Snapchat, tap your profile, then the gear icon for Settings. Choose My Data. You can also sign in at accounts.snapchat.com and choose My Data there.
  2. Turn on Export JSON Files. This is the step that matters: the conversations are read from the JSON.
  3. Turn on Chat History and the option to export chat media. You need both: the first gives the messages, the second gives the photos, videos and voice notes.
  4. Set the date range to all time, confirm your email address and submit.
  5. Snapchat emails you when the export is ready. Large accounts get several files named mydata~….zip. Download all of them and do not unzip them.

Snapchat changes the labels on this screen from time to time. If a name here does not match what you see, look for the options about JSON, chat history and chat media.

Reading it without Python or Docker

The free tools that read this export are a Python package and a Docker project. They work, and they need a computer and a command line. ThreadTidy does the matching in the browser: you drop the ZIP files, it reads chat_history.json, matches each media ID to its file, and gives you one page per conversation with the media in place. Nothing is uploaded.

ThreadTidy only reads chats. If your problem is Memories with the wrong date, that is a different job: see Restamp.

Read your Snapchat chats now

Drop the ZIP files and get a page per conversation. Free for 2 conversations, $9 once for all. Nothing is uploaded.

Read my chats