---
title: 'antispam:plugin:freemail'
url: 'https://docs.danami.com/warden/command-line-interface/antispam/antispam-plugin-freemail'
markdown: 'https://docs.danami.com/warden/command-line-interface/antispam/antispam-plugin-freemail.md'
date: '2026-10-07'
description: 'Check the headers for indication that a senders domain is that of a site offering free email services. warden --task=antispam:plugin:freemail Option Value Default Description --freemail_domains <string1,string2> List of domains to be used in checks. Regexp is not supported, but following…'
taxonomy:
  category:
    - docs
  tag:
    - freemail
---

[](#)  [ Basics ](https://docs.danami.com/warden/)     [ Command Line Interface ](https://docs.danami.com/warden/command-line-interface)      Antispam       antispam:plugin:freemail    

# antispam:plugin:freemail

Check the headers for indication that a senders domain is that of a site offering free email services.

```
warden --task=antispam:plugin:freemail
```

| Option | Value | Default | Description |
|---|---|---|---|
| `--freemail_domains` | <string1,string2> |  | List of domains to be used in checks. Regexp is not supported, but following wildcards work: ? for single character (does not match a dot). \* for multiple characters (does not match a dot) |
| `--freemail_domains_add` | <string> |  | Add a single entry to freemail\_domains. |
| `--freemail_domains_del` | <string> |  | Remove a single entry from freemail\_domains. |
| `--freemail_welcomelist` | <string1,string2> |  | Emails or domains listed here are ignored. (SpamAssassin 4.0+, no wildcards) |
| `--freemail_welcomelist_add` | <string> |  | Add a single entry to freemail\_welcomelist. |
| `--freemail_welcomelist_del` | <string> |  | Remove a single entry from freemail\_welcomelist. |
| `--freemail_import_welcomelist_auth` | <1\|0> | 0 | Entries in welcomelist\_auth will also be used to whitelist emails or domains from being freemail. (SA 4.0+) |
| `--freemail_import_def_welcomelist_auth` | <1\|0> | 0 | Entries in def\_welcomelist\_auth will also be used to whitelist emails or domains from being freemail. (SA 4.0+) |
| `--default` | <yes> |  | Reset all settings to their default values. |
| `--default_option` | <option> |  | Reset a specific setting to its default value. |
| `--reload` | <yes> |  | Reload the service after saving settings. |

## Examples

```
// set the freemail_domains
warden --task=antispam:plugin:freemail --freemail_domains='example.com,example2.com' --reload=yes

// reset freemail_domains to its default value
warden --task=antispam:plugin:freemail --default_option=freemail_domains --reload=yes

// reset all settings to their default values
warden --task=antispam:plugin:freemail --default=yes --reload=yes

// stop scoring mail from the guest mail domain as free mail service usage
warden --task=antispam:plugin:freemail --freemail_welcomelist_add='guests@example.com' --reload=yes

// also ignore freemail scoring for senders in the authenticated senders list
warden --task=antispam:plugin:freemail --freemail_import_welcomelist_auth=1 --reload=yes
```

## Related Pages

- [FreeMail Settings](https://docs.danami.com/warden/settings/antispam/plugin-settings/freemail "FreeMail Settings")
- [FreeMail](https://docs.danami.com/warden/user-guide/antispam-plugins/freemail "FreeMail")

 [ ](https://docs.danami.com/warden/user-guide/antispam-plugins/freemail) [](https://docs.danami.com/warden/settings/antispam/plugin-settings/freemail)

---

## Navigation

- Previous: [antispam:plugin:extracttext](https://docs.danami.com/warden/command-line-interface/antispam/antispam-plugin-extracttext.md)
- Next: [antispam:plugin:fromenamespoof](https://docs.danami.com/warden/command-line-interface/antispam/antispam-plugin-fromenamespoof.md)