Email Filters (Inbox Rules)
Filters are “IF X THEN Y” rules that fire automatically on incoming mail — apply a label, archive, star, mark read, forward, or delete.
Where to find them
Admin → Email → Email Filters (/admin/email/email_filter). Each rule is a row showing the IF condition + THEN action(s) + Edit / Disable / Delete buttons.
Rule order matters
Rules apply in the order they're listed. Drag the burger handle on a rule to reorder. Every matching rule fires — only the Delete action short-circuits the chain.
Conditions
Each rule has one or more conditions joined by AND (default) or OR.
| Field | Operators |
|---|---|
from | contains / equals / matches_regex |
to | contains / equals |
subject | contains / equals / matches_regex |
body | contains |
has_attachments | is true / false |
has_link | is true / false |
contains and equals are case-insensitive. matches_regex accepts PCRE-style patterns.
Actions
- Apply label — adds the chosen custom label to the thread
- Skip inbox — moves the message to Archive (still searchable)
- Star — flags as “important”
- Mark read — clears the unread badge
- Forward to <addr> — copies the message to another address
- Delete — moves to Trash (recoverable for 30 days)
Common patterns
| Pattern | Conditions | Actions |
|---|---|---|
| Auto-file receipts | from contains stripe.com OR from contains paypal.com | apply label “Receipts”, skip inbox |
| Star urgent alerts | subject contains [URGENT] | star, mark read = false |
| Auto-archive newsletters | has_link is true AND from contains newsletter | skip inbox |
| Forward customer mail | to equals support@dro.ng | forward to team@dro.ng |
Permissions
Creating / editing filter rules requires the email:filters:manage claim.
Default roles that have it: admin, tenant_admin, user.
Telemetry
Every rule fire emits a [:dro_email, :filter, :applied] event in the platform telemetry stream.
Admins can see which rules are doing work in the observability dashboard.