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:

AddressPurpose
dev@example.comPost to the list.
dev-request@example.comEmail commands (below).
dev-owner@example.comContact the owners — forwards the whole message to them.
dev-subscribe@example.comSubscribe shortcut.
dev-unsubscribe@example.comUnsubscribe shortcut.
dev-confirm+token@example.comDouble opt-in confirmation (sent to you by email).
dev-moderate+token@example.comModeration action by email.
dev-bounces+…@example.comVERP 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

CommandEffect
helpLists the available commands.
whichLists every list you’re subscribed to, across all domains, with status.
infoShows the list’s description, type, subscription policy, and posting rule.
set regular / set digest / set nomailChange your delivery preference. nomail pauses delivery without unsubscribing.
re-enableRe-activate a disabled subscription (resets the bounce count). Errors if it isn’t disabled.
unsubscribeRemove your subscription.
whoList the member roster. Restricted to owners and moderators.
contactForward 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.