How do I add new subscribers to my list?

This page is showing a generic answer.
To see a more detailed answer customized for you, type your domain name here:

You can use the Mailman pages to invite new recipients to join your list. This process also verifies the email addresses to make sure that the address is correct.

To do this, click Membership Management, then Mass Subscription on the Mailman administration pages. You'll see a screen that allows you to "Invite/Verify" new email addresses.

You should always use the "Invite/Verify" option on that page. Doing so is almost always required by our spam policy for your own protection: it completely protects you against false spam allegations.

On the rest of this page:

What happens when I invite a user?

When you invite new users, Mailman verifies the addresses for you by sending the following message (except that "ListName" is replaced with the real name of your list):

Subject: Verify your ListName subscription

Please follow the instructions below to join the "ListName" mailing list. You will not be subscribed if you ignore this message.

To join the list, visit this Web page:

If you prefer, you can join by replying to this email message. Your reply will be sent to a special address that adds you to the list. The text of your reply does not matter and will not be seen by a human being.

If you don't want to join this list, please ignore this message. If you have any questions, please send a separate message to

The recipient then has 20 days to click the link or reply. Their address will be added to the list when they do so.

This step is what protects you against false spam accusations. When someone clicks that link or replies, it provides permanent evidence that the person at that address actually agreed to subscribe (and was not mistakenly added because someone mistyped their own email address or something like that).

If we later receive spam complaints from verified addresses, we'll know the complaints are invalid and your list won't be affected. If people at verified addresses complain to other ISP or anti-spam blocklist operators, we can use the verification records to make sure the ISP or blocklist doesn't permanently block your mail.

What if the recipient doesn’t get the verification message?

Some mail systems filter all list mail, including the initial verification message, into folders named something like “Promotions”, “Bulk”, “Junk” or “Spam”.

If someone says they didn't get the message, they should search their mail (including folders like those) for your domain name, which will be in the subject of the message.

Can I change the message people receive?

You can change the subject and add additional text to the top of this message. In fact, we recommend doing so to include more information about your list. For example, you could include some text emphasizing that recipients won't be added to the list unless they reply to the verification message. You could also remind them that they gave you the addresses at, say, a school board meeting, and describe the purpose of the list.

Adding that kind of detail makes sure they won't mistake the verification message for "spam". But do keep it to the point: the idea is to get people to subscribe to the list, and that should be the focus of anything you add. If you have something else to tell them, do it separately after they've joined the list.

Do emphasize at the beginning of your text that people need to take action to be subscribed — if you bury that fact five paragraphs into the message, some people won't read that far. Some list administrators start the text with capital letters saying something like:


We don't include anything that dramatic by default because some people would object to that "tone", but feel free to use it yourself if you think it's appropriate.

Advanced topic: Subscribing users from another script

If you're a programmer creating a script that subscribes addresses to a list, you can do so by making a Web "GET" request to a certain URL. It should look like this:

Replace "listname" with the name of the Mailman list, and replace "" with the actual email address.

Making this Web request has the same result as inviting a user to join the list in the Mailman administrative pages.