---
title: 'antispam:plugin:welcomlistsubject'
url: 'https://docs.danami.com/warden/command-line-interface/antispam/antispam-plugin-welcomlistsubject'
markdown: 'https://docs.danami.com/warden/command-line-interface/antispam/antispam-plugin-welcomlistsubject.md'
date: '2026-10-07'
description: 'Whitelist or blacklist messages by Subject: header. warden --task=antispam:plugin:welcomlistsubject Option Value Default Description --welcomelist_subject <string1,string2> Whitelist particular strings in the Subject: header. Any subject matching these patterns will get SUBJECT_IN_WELCOM…'
taxonomy:
  category:
    - docs
  tag:
    - welcomelistsubject
---

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

# antispam:plugin:welcomlistsubject

Whitelist or blacklist messages by Subject: header.

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

| Option | Value | Default | Description |
|---|---|---|---|
| `--welcomelist_subject` | <string1,string2> |  | Whitelist particular strings in the Subject: header. Any subject matching these patterns will get `SUBJECT_IN_WELCOMELIST` -100 score applied to it. |
| `--welcomelist_subject_add` | <string> |  | Add a single entry to welcomelist\_subject. |
| `--welcomelist_subject_del` | <string> |  | Remove a single entry from welcomelist\_subject. |
| `--blocklist_subject` | <string1,string2> |  | Blacklist particular strings in the Subject: header. Any subject matching these patterns will get `SUBJECT_IN_BLOCKLIST` +100 score applied to it. |
| `--blocklist_subject_add` | <string> |  | Add a single entry to blocklist\_subject. |
| `--blocklist_subject_del` | <string> |  | Remove a single entry from blocklist\_subject. |
| `--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 welcomelist_subject
warden --task=antispam:plugin:welcomlistsubject --welcomelist_subject=Invoices --reload=yes

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

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

// whitelist the monitoring tool's alert subjects and blacklist the fake bank alert subject
warden --task=antispam:plugin:welcomlistsubject --welcomelist_subject_add='Server Monitoring Alert' --blocklist_subject_add='Account Verification Required' --reload=yes
```

## Related Pages

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

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

---

## Navigation

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