Skip to main content

Exporting Logs

Sometimes you need the audit trail outside the application — to attach to a compliance pack, share with an auditor, or analyze in a spreadsheet. The Export action lets you download the current view as a CSV or Excel file, and the Recent Exports panel keeps a history you can re-download.

:::note Export is a separate permission The Export and Recent Exports buttons appear in the page header only if you have export permission. Viewing the trail and exporting it are controlled independently, so some users can read the log without being able to download it. See Organization Roles. :::

What gets exported​

An export contains exactly the events that match your current filters — the same set you see in the table. To export a narrower slice, set up your filters first (see Using the Audit Log), then open the export modal. This makes it easy to produce, say, "all ownership changes this quarter" as a single file.

The export modal​

Click Export in the header to open the export modal. It offers:

  • Format — choose CSV or Excel (XLSX):
    • CSV is plain and universal, and opens cleanly in Excel.
    • Excel (XLSX) comes with styled headers and tidy column widths for a report-ready file.
  • A count of how many events will be exported, based on your active filters.

A few rules keep exports manageable:

  • Up to 10,000 events are included in a single file. If your filters match more, the modal warns you that only the first 10,000 will be exported and suggests narrowing your filters for a complete file.
  • Empty exports are blocked. If no events match your filters, the export is refused — and that blocked attempt is itself recorded in the audit trail.
  • Timestamps in the file use your organization's timezone, matching what you see on screen.

Click Export in the modal to start. Small exports download immediately; larger ones are prepared in the background, and you'll see a Generating export file… indicator while the file is built. When it's ready, the download starts automatically and a confirmation toast tells you how many events were exported.

Recent Exports​

Click Recent Exports in the header to open the export history panel. It lists the exports you've requested, newest first, each showing:

  • A status badge — Completed, Processing, Pending, or Failed.
  • The format (CSV or XLSX).
  • The row count and file size once the export has finished.
  • The time the export was requested, in your organization's timezone.

For any Completed export, a Download link lets you fetch the file again without re-running the export. Exports that are still being prepared show a spinner and update automatically as they finish.

:::tip Re-download instead of re-exporting If you just need another copy of a file you already generated, use Download in Recent Exports rather than running a fresh export. It's faster and avoids adding another export event to the trail. :::

Exports are audited​

Every export is itself an auditable action. Successful exports are recorded, and so are blocked attempts (such as trying to export with no matching results). This means the act of taking data out of the system is just as accountable as changing data inside it — you can always see who exported the audit log, when, and with what filters by filtering the trail on the Export action. See Using the Audit Log for how to filter by action.