How do I read a Slack export?
A Slack export is a ZIP with one folder per channel and one JSON file per day, and users.json maps the user IDs in the messages to names.
Updated November 15, 2026
What is in the export
- users.json: one entry per person, with
id(such asU02ABC123),name,real_nameandprofile.display_name. - channels.json: one entry per public channel, with
id,nameandmembers. Exports that include them also havegroups.json(private channels),dms.json(direct messages) andmpims.json(group messages). - One folder per channel, named after the channel. A direct message folder is named after its ID, such as
D01ABCDEF. Look it up indms.jsonto see who is in it. - One file per day in each folder, such as
general/2026-03-09.json. Each file is a list of messages.
Read a channel by hand
- Unzip the export.
- Open the folder of the channel you want, then the file for the day you want, in a text editor or in a browser tab.
- Each message has
user,textandts. Searchusers.jsonfor the value ofuserto find the person's name. tsis the time in seconds since January 1, 1970 (UTC). Paste the part before the dot into an epoch converter to get the date and time.- Inside
text,<@U02ABC123>is a mention of a person,<#C01DEF456|launch>is a channel, and<https://example.com|label>is a link.&,<and>stand for &, < and >. - A message with a
thread_tsdifferent from its owntsis a reply. Its parent is the message whosetsequals thatthread_ts. The parent can be in the file of an earlier day.
Things that trip people up
- Attached files are not in the ZIP. A message only has the file name and a
url_privatelink that needs a Slack login. - The standard export covers public channels. Private channels and direct messages are only in exports from plans or requests that include them.
- Joins and topic changes are messages too. They have a
subtypesuch aschannel_joinorchannel_topic. - Bots often have no
user. Look atusernameorbot_idinstead. - Day files follow the workspace's time zone, so a late message can sit in the file of the next or previous day compared with your own clock.
The faster way
ChannelTidy does this for the whole export in your browser: it replaces the IDs with names, rebuilds the threads and lets you search and download the conversations. Nothing is uploaded. It is free for any 2 channels per export and $19 one-time for every channel.