--- title: "show email-analysis policy" slug: "show-email-analysis-policy" tags: ["Reference", "CMS 11.x", "EX 11.x", "HX 10.x", "FX 11.x", "AX 11.x", "NX 11.x", "IVX 11.x", "Customer", "Network Security"] updated: 2026-08-04T17:21:43Z published: 2026-08-04T17:21:43Z canonical: "docs.trellix.com/show-email-analysis-policy" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # show email-analysis policy Displays detailed information about all the policy settings about email malware analysis. > [!NOTE] > Note > > Use the `show email-analysis policy` command to verify the status for Advanced URL Defense, typosquatting detection, and URL phishing in Release 8.0. ### Syntax `show email-analysis policy [message-tracking]` ### Parameters `message-tracking` (Optional) Displays the maximum number of days to retain email records for message tracking. ### Output fields The following table describes the output fields for the `show email-analysis policy` command. Fields are listed in the approximate order in which they appear in the output. | Field | Description | | --- | --- | | Analyze URLs in body | Whether URL scanning is enabled so that the Email Security — Server appliance can scan URLs within an email message body and either allow or block access to URLs. | | Analyze attachments | Whether the EMPS_ATTACHMENT_SCAN license is enabled so that the Email Security — Server appliance can submit email attachments for analysis. | | Analyze email using YARA | Whether YARA analysis is enabled. | | Email YARA Weight Cap | The weights of the matched rules are totaled to determine an overall score for the sample. | | Max Email Size (MB) | Maximum size (MB) limit for email to be submitted for analysis. | | Analysis Timeout (mins) | Number of minutes after which the malware analysis stops if the analysis is not complete. | | Analyze image URLs | When this option is enabled, a URL image is submitted for analysis. | | Advanced URL Defense | Whether Advanced URL Defense is enabled. The option to parse HTTP links is automatically enabled when Advanced URL Defense is enabled. | | Extract/Rewrite HTML URL as Text | Whether rewriting HTML URLs in email as text is enabled. | | Max URLs Analyzed/email | Maximum number of URLs that are analyzed per email. | | Max Att. Analyzed/email | Maximum number of attachments that are analyzed per email. | | Congestion Bypass Mode | Whether bypass congestion mode is enabled. | | Congestion Bypass Threshold | When the number of objects in the attachments queue exceeds this threshold, new incoming emails are accepted but are delivered without being analyzed. | | Congestion Refuse-connnection Mode | Whether refuse-congestion mode is enabled. | | Congestion High Threshold | When the number of emails in the email queue exceeds this threshold, the SMTP interface is disabled and all new incoming SMTP connections are refused. | | Congestion Low Threshold | When the number of emails in the email queue falls below this threshold, the SMTP interface is re-enabled and all new incoming SMTP connections are accepted. | | Enable X Header | Whether the X-Header option is enabled. If the advanced X-Header option is enabled, the "`Adv. X-header`" setting is displayed. When deployed in block mode or monitor mode, the appliance adds the X-Headers to describe the analysis and detection results by the Multivector Virtual Execution (MVX) engine. | | Use Header for To/From | Whether the Header Envelope feature is enabled. When you enable the Header Envelope feature, the original To: and From: email header information is displayed in the **eAlerts** page and **eQuarantine** page in the Email Security — Server Web UI. | | Parse HTTPS URLs | Whether the option to parse HTTP links is enabled. | | Invoke Email Feature Extractor | Whether email feature extraction is enabled. When you enable email feature extraction, the Email Security — Server appliance can scan the header and parts of the message body and extract the email features. | | Enable Notice (tap mode) | A notification message is sent to the recipient if a malicious email was detected in Tap/Span mode. | | Enable Notice (block mode) | A block notification message is sent to the list of recipients when the Email Security — Server appliance is deployed in block mode. | | Block notice from | The From email address header of a block notification message. | | Block notice subject | The Subject header of a block notification message. | | Block Admin Recipient(s) | Administrators are added to the list of recipients to receive the block notification message. | | Block BCC Recipient(s) | Bcc recipients are added to the list of recipients to receive the block notification message. | | TypoSquatting | Whether the typosquatting detection feature is enabled. When you enable typosquatting detection, the appliance can analyze suspicious sender and URL domains used in URLs within an email message body. | | Monitoring Enabled | Whether the monitor policy is enabled. | | Monitoring Interval (min) | Monitor alert interval period in minutes. | | Monitoring Bypass Threshold | Monitor alert bypass threshold limit. | | Monitoring Deferred Threshold | Monitor alert threshold limit in the deferred queue. | | Monitoring Backoff (sec) | Monitor alert backoff period in seconds. | | Text Attachment Analysis | Whether the option to submit an ASCII text attachment for analysis is enabled. | | Image Analysis | Whether the option to submit an image attachment for analysis is enabled. | ### Examples The following example displays all the policy settings about email malware analysis. ``` hostname # show email-analysis policy    Email-Analysis Policy:    Analyze URLs in body:      yes    Analyze attachments:          yes    Analyze email using YARA:     yes    Email YARA Weight Cap:        30    Max Email Size (MB):          35    Analysis Timeout (mins):      10    Analyze image URLs:           yes    Advanced URL Defense:         yes    Extract/Rewrite HTML URL as Text:    no    Max URLs Analyzed/email:      100    Max Att. Analyzed/email:      20    Congestion Bypass Mode:   yes    Congestion Bypass Threshold:   3000    Congestion Refuse-connnection Mode:   yes    Congestion High Threshold:    10000    Congestion Low Threshold:     9000    Enable X Header:              no    Use Header for To/From:       no    Parse HTTPS URLs:             yes    Invoke Email Feature Extractor:    yes    Enable Notice (tap mode):     yes    Enable Notice (block mode):   no    Block notice from:            admin@do-not-reply.com    Block notice subject:         Malicious email detected    Block Admin Recipient(s):      admin_haiti@haiti.com    Block BCC Recipient(s):      bcc_haiti@haiti.com    TypoSquatting:                yes    Monitoring Enabled  :      no    Monitoring Interval (min): 15    Monitoring Bypass Threshold:   1    Monitoring Deferred Threshold: 100    Monitoring Backoff (sec):      3600    Text Attachment Analysis:      no    Image Analysis:                no ``` The following example shows the maximum number of days to retain email records. ``` hostname # show email-analysis policy message-tracking Numbers of days of messages-tracking data retained:   18 ``` ### User role Admin, Analyst, Operator, or Monitor ### Command mode Enable ### Supported appliances This command is supported on the following appliances running the specified releases or later: - **Email Security — Server:** Before Release 7.5. The `message-tracking` parameter was added in Release 7.6. Command output was enhanced to include the `Typosquatting` setting in Release 7.8.0. Command output was enhanced to include the `Enable Notice (tap mode)` setting in Release 7.9.0. Use the `show analysis url-policy` command to verify the status for Advanced URL Defense, typosuatting detection, and URL phishing in Release 8.0. Command output was enhanced to include the `Text Attachment Analysis` setting in Release 8.0. Command output was enhanced to include whether the advanced X-Header is enabled in Release 8.0.2.