Email commands
A subscriber administers their own subscription by email, Mailman-style — no web
UI required. Commands go in the body of a message to the list’s -request address.
Address formats
xListman recognizes these special addresses on a list’s domain:
| Address | Purpose |
|---|---|
dev@example.com | Post to the list. |
dev-request@example.com | Email commands (below). |
dev-owner@example.com | Contact the owners — forwards the whole message to them. |
dev-subscribe@example.com | Subscribe shortcut. |
dev-unsubscribe@example.com | Unsubscribe shortcut. |
dev-confirm+token@example.com | Double opt-in confirmation (sent to you by email). |
dev-moderate+token@example.com | Moderation action by email. |
dev-bounces+…@example.com | VERP bounce return path (used automatically). |
How commands are parsed
Send a message to dev-request@example.com with one command per line in the
body. Commands are case-insensitive; blank lines and quoted (reply) lines are
ignored. Your From address is your identity — no passwords. If the body has no
command lines, it defaults to help.
All results come back as one combined plain-text reply from the list address.
Reply to that email to continue the conversation — the reply-to points back at the -request address.
The commands
| Command | Effect |
|---|---|
help | Lists the available commands. |
which | Lists every list you’re subscribed to, across all domains, with status. |
info | Shows the list’s description, type, subscription policy, and posting rule. |
set regular / set digest / set nomail | Change your delivery preference. nomail pauses delivery without unsubscribing. |
re-enable | Re-activate a disabled subscription (resets the bounce count). Errors if it isn’t disabled. |
unsubscribe | Remove your subscription. |
who | List the member roster. Restricted to owners and moderators. |
contact | Forward the rest of your message to the list’s owners. Everything after contact is your message text. |
Unknown or unauthorized commands always get a reply — never silence.
Subscribing
Request a subscription from the list’s web page or by writing to dev-subscribe@example.com. You’ll get a confirmation email with a -confirm link; confirming completes double opt-in:
- Open lists activate your subscription immediately.
- Moderated lists hold it for an owner’s approval first.
The confirmation expires after 48 hours. Closed lists reject self-service subscriptions — the owners add members directly.
Moderation by email
When a post of yours is held, you’ll get a notice telling you it’s awaiting
approval (with its expiry). And if you’re an owner or moderator, every held post
arrives as a moderation notice with the original message attached as message.eml and a reply-to like dev-moderate+token@example.com. Reply with a
body whose first non-quoted, non-blank line is approve, reject, or discard.
Next: Subscriptions & self-service.