Skip to content

Mattermost Archiver Plugin — User Guide

This plugin lets you export messages you can access in Mattermost into a ZIP file.

It supports:

  • Export the current channel (via a channel header button)
  • Export a multi-channel archive (via a picker modal)

No export option?

Export of teams and channels is only activated for team and channel admins. Direct and group messages can be exported by people involved in the conversation.

Privacy Note

Treat exported ZIPs as sensitive data (they may contain confidential messages, files and privacy related information).

1) Export the current channel

Available for team and channel admins. Direct and group messages can be exported by members of the channel.

  1. Open the channel you want to export.
  2. Click Export channel archive in the channel header.
  3. Configure options in the export picker (date range, attachments, HTML view, …).
  4. Click Download.

Screenshot: channel header with “Export channel archive”

2) Export this team

Available for team admins.

  1. Open the Team menu of any of your teams you have access to (top-left).
  2. Click Export this team.
  3. In the picker, select one or more channels.
  4. Choose export options.
  5. Click Download.

Screenshot: main menu item “Export this team”

Screenshot: picker with channel list

3) Export options (what they mean)

Date range

  • From: first day to include (inclusive, UTC)
  • To: last day to include (inclusive, UTC)

Tip: If your export is very large or slow, narrow the date range.

Attachments

  • When enabled, the ZIP includes uploaded files under a files/ folder.
  • The system admin can disable attachments entirely, and can enforce a maximum size per file.
  • If some files are skipped due to the size limit, the ZIP includes skipped_attachments.json describing what was omitted.

HTML view

The export always includes a human-friendly HTML view you can open locally.

  • Single page: one HTML file per channel (no chunk files)
  • Single-channel export: index.html
  • Multi-channel export: per-channel index.html
  • Paginated: multiple static HTML pages (Newer/Older navigation)
  • Lazy loading: an offline viewer that loads older messages as you scroll
  • Lazy mode generates a chunks/ folder inside the ZIP (this is expected for lazy mode)

Include machine-readable format

If the system admin allows it, you may see a checkbox like Include machine-readable format.

  • When enabled, the export includes JSON/NDJSON files intended for processing (scripts, tooling).
  • When disabled, the export omits machine-readable files and keeps only the HTML viewer (and attachments, if enabled).

What you’ll see in the ZIP depends on which export you run:

  • Single-channel export (when enabled): channel.json, posts.json
  • Multi-channel export (when enabled): index.json, per-channel channel.json, per-channel posts.ndjson

4) What’s inside the ZIP

Single-channel export

Typical contents:

  • index.html (always)
  • files/… (optional)
  • skipped_attachments.json (only if a max-size limit is enabled and some files were skipped)
  • channel.json, posts.json (only when machine-readable export is enabled and you opted in)

Multi-channel export

Typical contents:

  • index.html (always; entry point)
  • One folder per selected channel containing:
  • index.html (always)
  • files/… (optional)
  • channel.json, posts.ndjson (only when machine-readable export is enabled and you opted in)
  • skipped_attachments.json (only if a max-size limit is enabled and some files were skipped)
  • index.json (only when machine-readable export is enabled and you opted in)

5) Opening the HTML export

  1. Unzip the archive.

  2. Open the HTML entry point in a browser:

  3. Single-channel export: open index.html

  4. Multi-channel export: open index.html

Tip: For lazy-loading HTML exports, keep the entire folder structure (including chunks/) together.

6) Troubleshooting

“Export failed: 401 unauthorized”

You are not logged in (or your session expired). Refresh Mattermost and try again.

“Export disabled” / “forbidden”

Access is restricted to certain roles. Team exports are limited to team admins and channel exports in teams are limited to both channel and team admins. Direct and group messages outside of teams can be archived by members of the conversation.

If your team or channel has no available admin please contact us via support@hifis.net.

The export option isn’t visible

  • The plugin feature may be disabled for your account.
  • In some environments, UI placement can vary by Mattermost version.

The ZIP is huge / slow to download

  • Narrow the date range.
  • Disable attachments.
  • Consider Paginated or Lazy HTML for very large channels.