> ## 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.

# Change Storing of Previews

> Decide whether screenshots of messages and attachments are captured at all, and which verdicts trigger them.

<Note>
  **Preview retention**

  The retention time of the previews (if it's stored) is defined via [Change Metadata Retention](/latest/data-retention-metadata).
</Note>

## Change email previews

The default of email previews is:

* **Enabled** for malicious (red and orange) verdicts
* **Enabled** for all reported emails
* **Disabled** for benign (green) verdicts

To enable previews for all emails, add the following line to `local.properties`:

```shell local.properties theme={null}
DEFAULT_email_screenshot_value=true
```

To disable preview for a verdict, add the `*_email_screenshot=true` [variable](/latest/rule-parameters#parameters-for-email-classification) to `local.properties`. For example, to disable previews for all phishing emails:

```shell local.properties theme={null}
PHISHING_high_confidence_decision_email_screenshot=false
PHISHING_medium_confidence_decision_email_screenshot=false
PHISHING_low_confidence_decision_email_screenshot=false
```

## Change attachment previews

By default, attachment previews are only enabled if:

* A Sandbox analysis was made
* And the email is classified as malicious

To enable previews for all attachments that were scanned by the Sandbox, set all of the below parameters to `true` in `local.properties`.

To disable previews for all attachments, set all of the below parameters to `false` in `local.properties`.

| Property                                                        | Default value |
| --------------------------------------------------------------- | ------------- |
| `DEFAULT_keep_dana_assets_value` (default for all verdicts)     | `false`       |
| `SIMULATION_decision_keep_dana_assets`                          | `true`        |
| `BEC_decision_keep_dana_assets`                                 | `true`        |
| `EXTORTION_decision_keep_dana_assets`                           | `true`        |
| `BLACKLIST_decision_keep_dana_assets`                           | `true`        |
| `FILTER_high_confidence_decision_keep_dana_assets`              | `true`        |
| `FILTER_medium_confidence_decision_keep_dana_assets`            | `true`        |
| `FILTER_low_confidence_decision_keep_dana_assets`               | `true`        |
| `IMPERSONATION_high_confidence_decision_keep_dana_assets`       | `true`        |
| `IMPERSONATION_medium_confidence_decision_keep_dana_assets`     | `false`       |
| `MALWARE_dynamic_decision_keep_dana_assets`                     | `true`        |
| `MALWARE_static_decision_keep_dana_assets`                      | `true`        |
| `PHISHING_high_confidence_decision_keep_dana_assets`            | `true`        |
| `PHISHING_medium_confidence_decision_keep_dana_assets`          | `true`        |
| `PHISHING_low_confidence_decision_keep_dana_assets`             | `false`       |
| `SPAM_short_circuit_decision_keep_dana_assets`                  | `true`        |
| `SPAM_high_confidence_decision_keep_dana_assets`                | `true`        |
| `SPAM_medium_confidence_decision_keep_dana_assets`              | `true`        |
| `SPAM_low_confidence_decision_keep_dana_assets`                 | `true`        |
| `VIP_FRAUD_high_confidence_decision_keep_dana_assets`           | `true`        |
| `VIP_FRAUD_medium_confidence_decision_keep_dana_assets`         | `false`       |
| `INTERNAL_EXTORTION_decision_keep_dana_assets`                  | `true`        |
| `INTERNAL_PHISHING_high_confidence_decision_keep_dana_assets`   | `true`        |
| `INTERNAL_PHISHING_medium_confidence_decision_keep_dana_assets` | `true`        |
| `INTERNAL_PHISHING_low_confidence_decision_keep_dana_assets`    | `false`       |