Team: Huntress Managed Email Security (ES)
Product: Microsoft 365, Google Workspace
Environment: Cloud Email (Microsoft 365, Google Workspace)
Summary: Learn how the Huntress Managed Email Security Spam Filter moves spam and graymail out of end users' inboxes, how it differs from remediation, and how to turn it on or off for your account and organizations.
In this Article
Overview
Spam vs. Graymail
How Spam Filtering Works
Spam Filtering vs. Remediation
Correcting a Misclassified Message
Viewing Spam and Graymail Activity
Turning Spam Filtering On or Off
Common Questions
Overview
Huntress Managed Email Security (ES) detects and removes targeted attacks, including phishing, business email compromise (BEC), and malware. Along the way, many of the messages ES analyzes turn out to be spam or graymail rather than attacks.
The Spam Filter automatically moves these messages out of end users' inboxes. Unlike malicious messages, ES doesn't quarantine spam or graymail. Instead, ES moves these messages to folders that end users can still access, so nothing is hidden and end users can recover a misclassified message directly from that folder.
Spam filtering is on by default, including for organizations onboarded before this feature was released. You can turn it off for individual organizations and choose whether new organizations start with it on or off.
Spam vs. Graymail
ES categorizes non-malicious bulk messages into two classifications and routes them based on your email provider:
| Classification | What It Is | Where It Goes |
| Spam | Unsolicited bulk mail the recipient didn't ask for. |
Microsoft 365: The Junk Email folder Google Workspace: The Spam folder |
| Graymail | Bulk mail the recipient might have signed up for, such as newsletters, marketing emails, and promotions. |
Microsoft 365: A Promotions folder Google Workspace: The Promotions tab |
Microsoft 365: ES creates the Promotions folder in the mailbox automatically the first time it moves a graymail message. If an end user deletes the folder, ES recreates it the next time graymail arrives.
Google Workspace: Gmail labels graymail as a promotion rather than moving it, so it appears in Gmail's Promotions tab instead of the Primary inbox. This behavior relies on Gmail Inbox Categories, which are turned on by default. If an end user turns off the Promotions category, graymail still appears in their inbox.
How Spam Filtering Works
ES evaluates inbound messages in sequence to separate bulk mail from malicious threats:
ES analyzes inbound mail. When a detection rule matches a message, ES evaluates it further and assigns a verdict, such as malicious, spam, graymail, or benign.
If the verdict is spam or graymail and spam filtering is enabled for the organization, ES moves the message from the inbox to the matching folder.
If the verdict is malicious, Passive Mode or Enforcement Mode handles the message as usual. Spam filtering doesn't change how ES treats malicious messages.
Note: Spam filtering runs separately from Enforcement Mode. For new organizations, spam filtering begins when Historical Ingestion completes during onboarding, allowing ES to move spam and graymail out of the inbox while the tenant is still in Passive Mode. Learn more about Historical Ingestion, Passive Mode, and Enforcement.
Spam Filtering vs. Remediation
Spam filtering and remediation handle different message verdicts and give end users different levels of visibility:
| Behavior | Spam Filter | Remediation (Quarantine) |
| Applies to | Spam and graymail verdicts | Malicious verdicts |
| Where the message goes | The end user's Spam/Junk Email or Promotions folder | Removed from the mailbox and held where end users can't access it |
| Can the end user see it? | Yes | No |
| How to recover it | The end user moves it back to the Inbox | A Huntress Admin releases it from the quarantine log |
| Controlled by | The Spam Filter setting | Passive Mode / Enforcement Mode |
For details on quarantined messages, review Remediation and Quarantine.
Correcting a Misclassified Message
End users can fix a misclassified message themselves, and ES remembers their choice for that sender:
Moving a message out of Promotions, Junk Email, or Spam returns it to the Inbox and tells ES to deliver future messages from that sender to the folder the end user chose.
Moving a message into Promotions, Junk Email, or Spam tells ES to keep future messages from that sender there.
Keep the following rules in mind for sender preferences:
Preferences are per end user and per sender email address, not per domain. They don't affect other end users in the organization.
Preferences apply only to future messages. ES doesn't move previously delivered messages.
ES learns only from moves into or out of Promotions, Junk Email, or Spam (including their subfolders). Moving a message between other folders, such as from the Inbox to a custom folder, doesn't change anything.
Preferences never override protection against malicious mail. ES still remediates any message with a malicious verdict, regardless of the end user's preference.
Note: Restoring or excluding individual spam and graymail messages from the Huntress platform isn't currently available.
Viewing Spam and Graymail Activity
You can monitor filtered messages and daily trends for each organization in the Huntress platform:
Log in to Huntress and open an organization's Email Security section.
Select ES > Spam Filter.
Review the Spam & Graymail view, which lists messages moved out of the inbox by spam filtering, including each message's type (Spam or Graymail), sender, recipients, and flag timestamp. A daily chart shows spam and graymail counts over time.
In the quarantine log, these messages are labeled "Moved to Spam" or "Moved to Graymail", so you can tell them apart from quarantined messages.
Turning Spam Filtering On or Off
Spam filtering has two levels of control: an account default for new organizations, and a per-organization setting.
Important: Changing the account default doesn't change organizations that are already onboarded. To stop spam filtering for an existing organization, turn it off directly for that organization.
Turn Spam Filtering On or Off for an Organization
Follow these steps to change spam filtering for a single onboarded organization:
Log in to Huntress and go to ES > Spam Filter at the account level.
From the Organizations list, find the organization. You can use Search Organizations to filter the list.
Turn spam filtering on or off for that organization.
The change takes effect right away. Turning spam filtering off stops future messages from being moved, but previously moved messages stay in Promotions, Junk Email, or Spam. End users can move them back to the Inbox themselves.
Change the Account Default
Follow these steps to set the default spam filtering behavior for newly onboarded organizations:
Log in to Huntress and go to ES > Spam Filter at the account level.
In the Spam Filtering Default section, click Edit Default.
-
Select one of the following options:
Filter spam (Recommended): New organizations should start filtering spam and graymail once onboarding is complete.
Don't filter spam: New organizations leave spam and graymail in the inbox. Passive Mode or Enforcement Mode still handles malicious messages.
The selected option is marked Account default and applies only to organizations onboarded after the change.
Common Questions
Review answers to common questions about how the Spam Filter works alongside your email provider.
Is spam filtering on by default?
Yes. Spam filtering was turned on for existing organizations when the feature was released. Filter spam is also the recommended account default, so new organizations begin filtering spam and graymail when onboarding finishes.
I changed the account default to Don't filter spam, but messages are still being moved. Why?
The account default applies only to organizations onboarded after the change. Turn off spam filtering for the existing organization in the Organizations list on the Spam Filter page.
If I turn spam filtering off, are moved messages returned to the inbox?
No. Previously moved messages stay in Promotions, Junk Email, or Spam. End users can move them back to the Inbox themselves.
Can I restore or exclude individual spam or graymail messages from Huntress?
Not currently. End users can move a message back to the Inbox themselves, and ES delivers future messages from that sender to the folder they chose. Learn how end users can update sender preferences in Correcting a Misclassified Message.
Can I filter spam but leave graymail in the inbox?
No. The Spam Filter setting applies to both spam and graymail.
Does turning off spam filtering affect protection against malicious email?
No. Passive Mode or Enforcement Mode still handles malicious messages, whether spam filtering is on or off.
An end user reports that a newsletter or a legitimate email is missing. What should I check?
Check the organization's Spam Filter page to see whether ES moved the message. Then have the end user look in their Promotions folder or tab, or their Junk Email or Spam folder. Moving the message back to the Inbox also tells ES to deliver future messages from that sender to the Inbox.
Should I keep my email provider's built-in spam filtering?
Yes. ES works alongside Microsoft 365 and Google Workspace's built-in protection rather than replacing it. Keep your provider's built-in spam and junk filtering turned on.