The CSV Export feature allows you to export message log data from the current search results to a downloadable CSV file. Exports run in the background so they can handle large result sets without timing out.
Starting an Export
- Navigate to the Messages view
- Set your desired date range, search terms, and filters to define which messages to export
- Click the Export CSV button (download icon) in the toolbar
- The Export Builder modal appears, showing a list of column checkboxes
Selecting Columns
The Export Builder modal lets you choose which columns to include in the CSV file. All columns are checked by default. Uncheck any columns you don't need.
Available Columns
Column | Description |
|---|---|
User ID | Internal customer/user identifier |
Service ID | Service identifier |
Direction | Inbound or outbound |
Sending Username | SASL username (outbound) |
Credential | Sending credential ID (outbound) |
Message ID | MTA transaction ID |
Action ID | MTA recipient index |
Sender IP | IP address of the connecting sender |
Date | Timestamp of the message |
From | Sender address |
To | Recipient address |
Forward | Forwarded-to address (if applicable) |
Subject | Message subject line |
Action | Delivery action taken (DELIVER, REJECT, QUARANTINE, etc.) |
Action Reason | Reason for the action (e.g., spam score, policy rule) |
Result | SMTP delivery status/response |
Scores | Spam scores (SA, Rspamd, RPD) |
Delivery IP | Outbound IP used for delivery (if known) |
Destination MX | Destination MX hostname (if known) |
Destination IP | Destination server IP address (if known) |
Destination Port | Destination server port (if known) |
Include Column Headers
At the bottom of the column list, the "Include column headers as first row" checkbox (checked by default) controls whether the first row of the CSV file contains column names.
Submitting the Export
Click the Export button to submit. The export job is created in the background and you are redirected to the Export Status page.
Monitoring Export Progress
The Export Status page shows the details and progress of your export job.
The page displays:
- Export ID and creation timestamp
- Query summary — the date range, search terms, and filters that define the export scope
- Selected columns — which fields are included
- Status indicator:
- Queued — waiting to be picked up by the cron job
- Running — actively exporting records, with a progress bar showing records processed vs. total
- Completed — export finished, download button available
- Failed — export encountered an error, with error message displayed
The page auto-refreshes while the job is queued or running — you don't need to manually reload. The progress bar updates every few seconds.
Downloading the File
Once the export completes, a Download CSV button appears.
Click Download CSV to download the file. The file is named with the export job ID and can be opened in any spreadsheet application.
Navigating Back
Click the back arrow link in the top navigation bar to return to the Messages view with your original search parameters preserved.