How do I open conversations.json from a ChatGPT export?

conversations.json is one large JSON array where each conversation stores its messages as a tree under "mapping", so a text editor shows it as one unreadable line.

Updated November 15, 2026

What is in the export

What chat.html gives you, and its limits

Double-click chat.html and your browser shows every conversation, one after another, on a single page. For a short history that is enough to read and to search with Ctrl+F or Cmd+F.

Read conversations.json by hand

  1. Unzip the export.
  2. Do not open conversations.json in a normal text editor. Use a tool made for large JSON. On the command line, jq '.[].title' conversations.json lists the titles and jq '.[0]' conversations.json prints the first conversation with line breaks.
  3. In one conversation, read current_node. That is the ID of the last message shown in ChatGPT.
  4. Find that ID in mapping. Each entry has a parent, a list of children and a message.
  5. Follow parent from entry to entry until there is no parent. Reverse that list. This is the conversation in reading order.
  6. For each message, author.role says who wrote it (user, assistant, system or tool) and content.parts holds the text.

Things that trip people up

The faster way

ConvoTidy does these steps for the whole export in your browser and writes one Markdown file per conversation, with the images and an index. Nothing is uploaded. It is free for your 25 most recent conversations and $9 one-time for all of them.

Convert my export