# Export and retention

Use exports for reporting, incident response, and compliance. Use retention to control how long audit history is kept.

### Export logs

<figure><img src="https://3820804400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfW6XSzJSKsNyZnOkSJPt%2Fuploads%2FoQuh2MXKVCNI8RVIhg4V%2FCleanShot%202026-02-09%20at%2013.02.07%402x.png?alt=media&#x26;token=61e87606-1379-406b-a7c4-f29180d4e5f1" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### (Optional) Apply filters

Use date range, user, status, and event type to narrow the export.
{% endstep %}

{% step %}

### Export

Click **Export**.
{% endstep %}

{% step %}

### Choose a format

* **CSV** for spreadsheets
* **JSON** for SIEM tools and automation
  {% endstep %}
  {% endstepper %}

{% hint style="info" %}
Exports are limited to **10,000 rows**. Use date filters and export in batches.
{% endhint %}

### Retention

Audit logs older than your retention period are deleted automatically.

{% hint style="info" %}
Default retention is **365 days**.
{% endhint %}

<figure><img src="https://3820804400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfW6XSzJSKsNyZnOkSJPt%2Fuploads%2Fs33VWYYjV7wSbbm5qBOW%2FCleanShot%202026-02-09%20at%2013.03.04%402x.png?alt=media&#x26;token=d20af27e-17a6-4abf-b322-8919c3b58752" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Deletion is permanent. We cannot recover deleted audit logs.
{% endhint %}

{% stepper %}
{% step %}

### Open audit log settings

Go to **Account Settings → Security → Audit logs**.
{% endstep %}

{% step %}

### Set a retention period

Pick a period from **30 days to 7 years**.
{% endstep %}

{% step %}

### Save

Click **Save**.
{% endstep %}
{% endstepper %}