> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xorlab.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Pages under /latest/ document the current release. Paths that begin with a version number, for example /10.0/, are frozen snapshots of superseded releases kept for reference only — never present their instructions as current. If the reader's version is unknown, answer from /latest/ and say which version the answer describes.
> xorlab is deployed on-premises, hybrid, or as a cloud service, and integrates with either Microsoft 365 or on-premises mail infrastructure. Configuration steps often differ between these. State which deployment and integration mode an instruction applies to instead of presenting one as universal.
> Distinguish inline mode from monitoring mode when describing anything that acts on email. Monitoring mode observes a copy and cannot block or quarantine; inline mode routes mail through xorlab and can.
> Write the product name as lowercase 'xorlab'. Use the documented component names: xorlab Control Center (XCC), xorlab MTA, xorlab Sandbox (DANA), xorlab Natural Language Understanding (NLU). After the first mention, use the short forms XCC, MTA, Sandbox, and NLU. Do not use DANA as a standalone name for the Sandbox, but keep it where it is a literal string in configuration keys, container names, and hostnames.
> Do not invent configuration keys, rule parameters, list names, log properties, or API fields. If a value is not present in this documentation, say that it is not documented rather than guessing.

# Data Retention Overview

> What xorlab stores, for how long by default, and which retention settings you can change.

The default settings are sufficient for most environments. The table below shows what you can configure if needed.

| Type                                                                                | Description                                                                                       | Default                          |
| :---------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------ | :------------------------------- |
| [Change Metadata Retention](/latest/data-retention-metadata)                        | How long emails are searchable and visible in the web interface.                                  | 90 days                          |
| [Change Quarantine Retention](/latest/data-retention-quarantine)                    | How long malicious emails are kept in the quarantine.                                             | 30 days                          |
| [Change Storing of Subject](/latest/data-retention-subject)                         | If and when email subjects are stored.                                                            | Always stored                    |
| [Change Storing of Previews](/latest/data-retention-previews)                       | If and when email and attachment previews are stored.                                             | Stored only for malicious emails |
| [Change Log and Metric Retention](/latest/monitoring-data-retention) (on-prem only) | How long to keep operational logs and monitoring metrics. Applicable only for on-premises setups. | 30 days                          |

## Multi-Tenancy

Everything except log and metric retention can be set per tenant:

| Type                                                                                | In a multi-tenant deployment                                                                                                                                                                                                 |
| :---------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Change Metadata Retention](/latest/data-retention-metadata)                        | Per tenant in `shared/guarded_tenants.yml`.                                                                                                                                                                                  |
| [Change Quarantine Retention](/latest/data-retention-quarantine)                    | Per tenant in `shared/guarded_tenants.yml`.                                                                                                                                                                                  |
| [Change Storing of Subject](/latest/data-retention-subject)                         | Per tenant in `shared/guarded_tenants.yml`.                                                                                                                                                                                  |
| [Change Storing of Previews](/latest/data-retention-previews)                       | Configured in `local.properties`, which applies to all tenants. To change it for one tenant only, use a `tenant.properties` file instead, see [Manage Tenant Rules](/latest/multi-tenancy-rules#tenant-specific-parameters). |
| [Change Log and Metric Retention](/latest/monitoring-data-retention) (on-prem only) | **Instance-wide only.** Cannot be configured per tenant.                                                                                                                                                                     |

To apply the same `guarded_tenants.yml` retention settings to many tenants at once, define them in a shared config template: [Using Tenant Config Templates](/latest/multi-tenancy-configsets).

For more information:

* [Data Storage](/latest/data-storage)
* [Data Flow Overview](/latest/data-flow-overview)