Skip to content

Sender rules

Sender rules provide a simple blocklist and allowlist that runs before normal filters whenever new mail is synchronized.

Behavior

  • A block rule moves matching mail to the detected Trash folder.
  • An allow rule for the same normalized sender overrides a block rule.
  • Display-name addresses are normalized to their lowercase email address.
  • Rules affect newly processed mail; use normal message actions for existing messages.
  • If no Trash mailbox can be detected, blocked mail is left in place.

Sender rules are exact normalized-address matches, not domain-wide patterns. Add each address that should be blocked or explicitly allowed.

Configuration

ItemSetting nameEnvironment variableRequirement
Block or allow senderSettings > Senders > Type and SenderNoneA sender value is required.
Move blocked mailSettings > IMAP > Host, Username / Email, and Password, plus a detectable Trash folderIMAP_HOST, IMAP_USER, and IMAP_PASSWORD, or IMAP_SERVERSRequired for the worker to move mail upstream.

No sender-rule-specific environment variable exists. Rules are stored in PostgreSQL and applied by the worker during sync.