MailmanListAdmin - Revision history

Arianneg: /* For list moderators */

2026-03-30T20:56:33Z

For list moderators

← Older revision		Revision as of 20:56, 30 March 2026
Line 68:		Line 68:
	====For list moderators====		====For list moderators====
	Moderators and administrators will receive an email similar to the following if a message is being held for moderation:		Moderators and administrators will receive an email similar to the following if a message is being held for moderation:
	:[[File:Moderationemail.png]]		:[[File:Moderationemail.png\|alt=Screen of example email to expect if something is held for moderation]]

	The provided URL can also be visited at any time to view the queue of messages pending moderation:		The provided URL can also be visited at any time to view the queue of messages pending moderation:
Line 78:		Line 78:
	There are two ways messages from senders may appear on this interface, depending on whether or not the sender is a member of the list:		There are two ways messages from senders may appear on this interface, depending on whether or not the sender is a member of the list:
	* If the sender is a member of the list (but their moderation bit is on):		* If the sender is a member of the list (but their moderation bit is on):
	*: [[File:Moderatedmember_held.png]]		*: [[File:Moderatedmember_held.png\|alt=Screenshot of message pending moderation when the sender is a member of the list it is being sent to]]
	* If the sender is not a member of the list:		* If the sender is not a member of the list:
	*: [[File:Nonmember_held.png]]		*: [[File:Nonmember_held.png\|alt=Screenshot of message pending moderation when the sender is not a member of the list it is being sent to]]

	From these windows, you can choose an action (Defer, Accept, Reject, Discard) for all messages from a specific sender via the radio buttons in the left sub-window, or handle individual messages by clicking on the [#] hyperlinks next to each subject line.		From these windows, you can choose an action (Defer, Accept, Reject, Discard) for all messages from a specific sender via the radio buttons in the left sub-window, or handle individual messages by clicking on the [#] hyperlinks next to each subject line.

Arianneg: /* Setup */

2026-03-30T20:54:25Z

Setup

← Older revision		Revision as of 20:54, 30 March 2026
Line 62:		Line 62:

	List admins can add moderators to a list by entering their email addresses in the "The list moderator email addresses. Multiple moderator addresses, each on separate line is okay." box on the "General Options" page of the list's admin interface:		List admins can add moderators to a list by entering their email addresses in the "The list moderator email addresses. Multiple moderator addresses, each on separate line is okay." box on the "General Options" page of the list's admin interface:
	:[[File:Mailmanmoderators.png]]		:[[File:Mailmanmoderators.png\|alt=Screenshot of admin interface highlighting the previously described box]]

	As soon as the first moderator is added to the list, a list admin should set the moderator password and communicate it to the initial moderator(s). This password can only be changed by a list admin. It does not give full administrative access to the list.		As soon as the first moderator is added to the list, a list admin should set the moderator password and communicate it to the initial moderator(s). This password can only be changed by a list admin. It does not give full administrative access to the list.

Mbaney at 16:17, 11 March 2026

2026-03-11T16:17:37Z

← Older revision		Revision as of 16:17, 11 March 2026
Line 1:		Line 1:
	==Mailman List Administration==		==Mailman List Administration==
	The full documentation can be found at (among other places) the Mailman administrators guide: ~~http~~://www.gnu.org/software/mailman/		The full documentation can be found at (among other places) the Mailman administrators guide: https://www.gnu.org/software/mailman/

	Once UMIACS staff has created your list, they will tell you what the password is for managing this list. You'll need this password to do various list management things such as add/remove users, approve user subscription or postings for restricted lists, and tailor the list.		Once UMIACS staff has created your list, they will tell you what the password is for managing this list. You'll need this password to do various list management things such as add/remove users, approve user subscription or postings for restricted lists, and tailor the list.
Line 6:		Line 6:
	If staff was provided with a list of initial subscribers, these people will have already been subscribed. Tell your users that if they'd like to subscribe, they need only go to		If staff was provided with a list of initial subscribers, these people will have already been subscribed. Tell your users that if they'd like to subscribe, they need only go to

	~~http~~://lists.umiacs.umd.edu/mailman/listinfo/LISTNAME		https://lists.umiacs.umd.edu/mailman/listinfo/LISTNAME

	even if the list is private (not advertised or listed).		even if the list is private (not advertised or listed).
Line 19:		Line 19:
	To manage your list, go to:		To manage your list, go to:

	~~http~~://lists.umiacs.umd.edu/mailman/admin/LISTNAME		https://lists.umiacs.umd.edu/mailman/admin/LISTNAME

	You will be prompted for the aforementioned password. In general, most of the default settings are likely to be fine but you should know about the following capabilities and pieces of information.		You will be prompted for the aforementioned password. In general, most of the default settings are likely to be fine but you should know about the following capabilities and pieces of information.
Line 27:		Line 27:

	====Membership Management====		====Membership Management====
	~~http~~://lists.umiacs.umd.edu/mailman/admin/LISTNAME/members		https://lists.umiacs.umd.edu/mailman/admin/LISTNAME/members

	This is where you can subscribe and unsubscribe users, hide their email addresses, and more.		This is where you can subscribe and unsubscribe users, hide their email addresses, and more.
Line 35:		Line 35:

	====Privacy options====		====Privacy options====
	~~http~~://lists.umiacs.umd.edu/mailman/admin/LISTNAME/privacy		https://lists.umiacs.umd.edu/mailman/admin/LISTNAME/privacy

	This is where you can specify whether or not the list is visible to the world, whether or not administrative approval is required to subscribe to the list, who can view the list of subscribers, who can post to the list (is it open or moderated?), and more.		This is where you can specify whether or not the list is visible to the world, whether or not administrative approval is required to subscribe to the list, who can view the list of subscribers, who can post to the list (is it open or moderated?), and more.

	====Archiving Options====		====Archiving Options====
	~~http~~://lists.umiacs.umd.edu/mailman/admin/LISTNAME/archive		https://lists.umiacs.umd.edu/mailman/admin/LISTNAME/archive

	This is where you can choose whether or not to archive messages send to the list. By default, messages are archived and are available only to subscribers of the list using their subscribing password at ~~http~~://lists.umiacs.umd.edu/mailman/private/LISTNAME. You can change this to make messages available to the public or turn off archiving entirely. '''Archives are not searchable.'''		This is where you can choose whether or not to archive messages send to the list. By default, messages are archived and are available only to subscribers of the list using their subscribing password at https://lists.umiacs.umd.edu/mailman/private/LISTNAME. You can change this to make messages available to the public or turn off archiving entirely. '''Archives are not searchable.'''

	===General Settings===		===General Settings===
Line 72:		Line 72:
	The provided URL can also be visited at any time to view the queue of messages pending moderation:		The provided URL can also be visited at any time to view the queue of messages pending moderation:

	~~http~~://lists.umiacs.umd.edu/mailman/admindb/LISTNAME		https://lists.umiacs.umd.edu/mailman/admindb/LISTNAME

	From here, if there are one or more messages pending moderation, you will see a summary of the messages broken down per-sender. Please note that the addresses in these screenshots are hidden for privacy, but will appear on the actual moderation page.		From here, if there are one or more messages pending moderation, you will see a summary of the messages broken down per-sender. Please note that the addresses in these screenshots are hidden for privacy, but will appear on the actual moderation page.

Mbaney at 18:31, 5 March 2020

2020-03-05T18:31:11Z

← Older revision		Revision as of 18:31, 5 March 2020
Line 58:		Line 58:

	===Moderated Lists===		===Moderated Lists===
			====Setup====
	If you want your list to be moderated (i.e. ONLY you and/or a few others can post to it), this can be set at the bottom of the "Membership Management" --> "Membership List" page. Make sure to also set this for all new members under "Privacy options" --> "Sender filters". If moderation is set, make sure the list admin (and/or whomever you want to be able to send to the list) has their moderation bit turned off.		If you want your list to be moderated (i.e. ONLY you and/or a few others can post to it), this can be set at the bottom of the "Membership Management" --> "Membership List" page. Make sure to also set this for all new members under "Privacy options" --> "Sender filters". If moderation is set, make sure the list admin (and/or whomever you want to be able to send to the list) has their moderation bit turned off.

Line 65:		Line 66:
	As soon as the first moderator is added to the list, a list admin should set the moderator password and communicate it to the initial moderator(s). This password can only be changed by a list admin. It does not give full administrative access to the list.		As soon as the first moderator is added to the list, a list admin should set the moderator password and communicate it to the initial moderator(s). This password can only be changed by a list admin. It does not give full administrative access to the list.

			====For list moderators====
	Moderators and administrators will receive an email similar to the following if a message is being held for moderation:		Moderators and administrators will receive an email similar to the following if a message is being held for moderation:
	:[[File:Moderationemail.png]]		:[[File:Moderationemail.png]]

Mbaney: /* Moderated Lists */

2020-02-18T19:03:37Z

Moderated Lists

← Older revision		Revision as of 19:03, 18 February 2020
Line 63:		Line 63:
	:[[File:Mailmanmoderators.png]]		:[[File:Mailmanmoderators.png]]

	As soon as a moderator is added to the list, a list admin should set the moderator password and communicate it to the initial moderator(s). This password can only be changed by a list admin. It does not give full administrative access to the list.		As soon as the first moderator is added to the list, a list admin should set the moderator password and communicate it to the initial moderator(s). This password can only be changed by a list admin. It does not give full administrative access to the list.

	Moderators and administrators will receive an email similar to the following if a message is being held for moderation:		Moderators and administrators will receive an email similar to the following if a message is being held for moderation:

Mbaney: /* Moderated Lists */

2020-02-18T18:30:17Z

Moderated Lists

← Older revision		Revision as of 18:30, 18 February 2020
Line 65:		Line 65:
	As soon as a moderator is added to the list, a list admin should set the moderator password and communicate it to the initial moderator(s). This password can only be changed by a list admin. It does not give full administrative access to the list.		As soon as a moderator is added to the list, a list admin should set the moderator password and communicate it to the initial moderator(s). This password can only be changed by a list admin. It does not give full administrative access to the list.

	~~If you are~~ a ~~moderator~~ for ~~a list and want~~ to view the queue of messages pending moderation~~, go to~~:		Moderators and administrators will receive an email similar to the following if a message is being held for moderation:
			:[[File:Moderationemail.png]]

			The provided URL can also be visited at any time to view the queue of messages pending moderation:

	http://lists.umiacs.umd.edu/mailman/admindb/LISTNAME		http://lists.umiacs.umd.edu/mailman/admindb/LISTNAME

Mbaney: /* Moderated Lists */

2020-02-18T14:39:46Z

Moderated Lists

← Older revision		Revision as of 14:39, 18 February 2020
Line 69:		Line 69:
	http://lists.umiacs.umd.edu/mailman/admindb/LISTNAME		http://lists.umiacs.umd.edu/mailman/admindb/LISTNAME

	From here, if there are one or more ~~messaged~~ pending moderation, you will see a summary of the messages broken down per-sender. Please note that the addresses in these screenshots are hidden for privacy, but will appear on the actual moderation page.		From here, if there are one or more messages pending moderation, you will see a summary of the messages broken down per-sender. Please note that the addresses in these screenshots are hidden for privacy, but will appear on the actual moderation page.

	There are two ways messages from senders may appear on this interface, depending on whether or not the sender ~~was part~~ of the list:		There are two ways messages from senders may appear on this interface, depending on whether or not the sender is a member of the list:
	* If the sender ~~was~~ a member of the list (but their moderation bit is on):		* If the sender is a member of the list (but their moderation bit is on):
	*: [[File:Moderatedmember_held.png]]		*: [[File:Moderatedmember_held.png]]
	* If the sender ~~was~~ not a member of the list:		* If the sender is not a member of the list:
	*: [[File:Nonmember_held.png]]		*: [[File:Nonmember_held.png]]

Mbaney: /* Moderated Lists */

2020-02-18T14:35:22Z

Moderated Lists

← Older revision		Revision as of 14:35, 18 February 2020
Line 58:		Line 58:

	===Moderated Lists===		===Moderated Lists===
	If you want your list to be moderated (i.e. ONLY you and/or a few others can post to it), this can be set at the bottom of the "Membership Management" --> "Membership List" page. Make sure to also set this for all new members under "Privacy options" --> "Sender filters". If moderation is set, make sure the list admin (and/or whomever you want to be able to send to the list has ~~his/her~~ moderation bit turned off.)		If you want your list to be moderated (i.e. ONLY you and/or a few others can post to it), this can be set at the bottom of the "Membership Management" --> "Membership List" page. Make sure to also set this for all new members under "Privacy options" --> "Sender filters". If moderation is set, make sure the list admin (and/or whomever you want to be able to send to the list) has their moderation bit turned off.

			List admins can add moderators to a list by entering their email addresses in the "The list moderator email addresses. Multiple moderator addresses, each on separate line is okay." box on the "General Options" page of the list's admin interface:
			:[[File:Mailmanmoderators.png]]

			As soon as a moderator is added to the list, a list admin should set the moderator password and communicate it to the initial moderator(s). This password can only be changed by a list admin. It does not give full administrative access to the list.

	If you are a moderator for a list and want to view the queue of messages pending moderation, go to:		If you are a moderator for a list and want to view the queue of messages pending moderation, go to:

	http://lists.umiacs.umd.edu/mailman/admindb/LISTNAME		http://lists.umiacs.umd.edu/mailman/admindb/LISTNAME

	Please note that either the administrator password or a separately-set moderator password will work here. This is to allow moderators to perform their responsibilities without giving them full control of a list.

	From here, if there are one or more messaged pending moderation, you will see a summary of the messages broken down per-sender. Please note that the addresses in these screenshots are hidden for privacy, but will appear on the actual moderation page.		From here, if there are one or more messaged pending moderation, you will see a summary of the messages broken down per-sender. Please note that the addresses in these screenshots are hidden for privacy, but will appear on the actual moderation page.

Mbaney: /* General Settings */

2020-02-17T21:16:01Z

General Settings

← Older revision		Revision as of 21:16, 17 February 2020
Line 48:		Line 48:

	Options under ''Subscribing'' under "Privacy options":		Options under ''Subscribing'' under "Privacy options":
	* By default, no one can see the list. If this is not the behavior you want, change the setting on the first item "Advertise this list when people ask what lists are on this machine?" from NO to YES, and then "Submit Your Changes" on the bottom of the page. Note that even if users can't see the list, they can still subscribe (or try to subscribe). They simply need to know the URL.		* By default, no one can see the list.
	* By default, anyone can subscribe to the list. (To ensure that someone can't subscribe someone else as a prank, Mailman sends a confirm email message to the users asking something like, "You have been subscribed to.... Are you sure you want to subscribe? Just REPLYing to this message will subscribe you"). If this is not the behavior you want, change the setting on the second item "What steps are required for subscription?" and click "Require approval" or "Confirm and approve" and then "Submit Your Changes" on the bottom of the page. Approval means that you, as the list administrator, will get a message saying USER@HOST wants to subscribe. You can then approve or discard their request.		** If this is not the behavior you want, change the setting on the first item "Advertise this list when people ask what lists are on this machine?" from NO to YES, and then "Submit Your Changes" on the bottom of the page. Note that even if users can't see the list, they can still subscribe (or try to subscribe). They simply need to know the URL.
			* By default, anyone can subscribe to the list. (To ensure that someone can't subscribe someone else as a prank, Mailman sends a confirm email message to the users asking something like, "You have been subscribed to.... Are you sure you want to subscribe? Just REPLYing to this message will subscribe you").
			** If this is not the behavior you want, change the setting on the second item "What steps are required for subscription?" and click "Require approval" or "Confirm and approve" and then "Submit Your Changes" on the bottom of the page. Approval means that you, as the list administrator, will get a message saying USER@HOST wants to subscribe. You can then approve or discard their request.

	Option under ''Membership exposure'' under "Privacy options":		Option under ''Membership exposure'' under "Privacy options":
	* By default, only list members can see the email addresses of other list members. '''Users can hide their own addresses from their list subscription page'''. Likewise, you can hide some users and not others from the ~~Administrators~~ Membership Management page. If you want to broadly change visibility for all users, change the setting on the first item "Who can view subscription list?" and click either "Anyone" or "List admin only" and then "Submit Your Changes" on the bottom of the page.		* By default, only list members can see the email addresses of other list members. '''Users can hide their own addresses from their list subscription page'''. Likewise, you can hide some users and not others from the "Membership Management" page.
			** If you want to broadly change visibility for all users, change the setting on the first item "Who can view subscription list?" and click either "Anyone" or "List admin only" and then "Submit Your Changes" on the bottom of the page.

	===Moderated Lists===		===Moderated Lists===

Mbaney at 21:07, 17 February 2020

2020-02-17T21:07:29Z

← Older revision		Revision as of 21:07, 17 February 2020
Line 24:		Line 24:

	* Just because you are the list administrator doesn't mean you're subscribed to (or you have to be subscribed to) this list.		* Just because you are the list administrator doesn't mean you're subscribed to (or you have to be subscribed to) this list.
	* Under the Membership Management page, you can unsubscribe users, hide their email address and more.
	** To subscribe other people, on this form, enter their addresses in the text window under the "Mass Subscription" section. Please note that if the user you are adding has a UMD address, you should use that address in order to comply with the [https://umd.service-now.com/itsupport/?sys_kb_id=6b102078dbbec8d06aa4151748961927&id=kb_article_view&sysparm_rank=2&sysparm_tsqueryId=c11ba448db4788906aa4151748961904#institutional-email-standard Institutional email standard].
	** If a user goes on vacation, you can change the option to "nomail" for them on this form turning off mailing to that individual until he/she returns. Of course, users can do this themselves as well.
	** If a user forgets their password, clicking on the user's email address on this form allows you to send them an email message containing their password.
	* Under Privacy options, you can specify whether or not the list is visible to the world, whether or not administrative approval is required to subscribe to the list, who can view the list of subscribers, who can post to the list (is it open or moderated?) and more.
	* Under Archiving Options, you can choose whether or not to archive messages send to the list. By default, messages are archived and are available only to subscribers of the list using their subscribing password at http://lists.umiacs.umd.edu/mailman/private/LISTNAME. You can change this to make messages available to the public or turn off archiving entirely.choose whether these are available to the public or only subscribers (private). '''This archive is currently not searchable.'''
	* Messages sent out aren't necessarily delivered immediately; it could take up to 5 minutes.		* Messages sent out aren't necessarily delivered immediately; it could take up to 5 minutes.

	===~~General Settings~~===		====Membership Management====
	~~Most of~~ the ~~defaults for lists~~ are ~~probably fine but~~ a ~~number of them bear special mention~~. ~~These are~~ the ~~options under~~ "~~Privacy options~~".		http://lists.umiacs.umd.edu/mailman/admin/LISTNAME/members

			This is where you can subscribe and unsubscribe users, hide their email addresses, and more.
			* To subscribe other people, on this form, enter their addresses in the text window under the "Mass Subscription" section. Please note that if the user you are adding has a UMD address, you should use that address in order to comply with the [https://umd.service-now.com/itsupport/?sys_kb_id=6b102078dbbec8d06aa4151748961927&id=kb_article_view&sysparm_rank=2&sysparm_tsqueryId=c11ba448db4788906aa4151748961904#institutional-email-standard Institutional email standard].
			* If a user goes on vacation, you can change the option to "nomail" for them on this form turning off mailing to that individual until he/she returns. Of course, users can do this themselves as well.
			* If a user forgets their password, clicking on the user's email address on this form allows you to send them an email message containing their password.

			====Privacy options====
	http://lists.umiacs.umd.edu/mailman/admin/LISTNAME/privacy		http://lists.umiacs.umd.edu/mailman/admin/LISTNAME/privacy

	~~By default, NO one~~ can ~~see~~ the list~~. If this~~ is not the ~~behavior you want~~, ~~change~~ the ~~setting on the first item~~ of the ~~page: "Advertise this~~ list ~~when people ask what lists are on this machine~~?"		This is where you can specify whether or not the list is visible to the world, whether or not administrative approval is required to subscribe to the list, who can view the list of subscribers, who can post to the list (is it open or moderated?), and more.

	~~Change this from NO to YES, On the bottom of the page, and click "Submit Your Changes"~~.		====Archiving Options====
			http://lists.umiacs.umd.edu/mailman/admin/LISTNAME/archive

	~~Note that even if users~~ can~~'t see~~ the list, ~~they~~ can ~~still subscribe (or try~~ to ~~subscribe). They simply need~~ to ~~know~~ the ~~URL~~.		This is where you can choose whether or not to archive messages send to the list. By default, messages are archived and are available only to subscribers of the list using their subscribing password at http://lists.umiacs.umd.edu/mailman/private/LISTNAME. You can change this to make messages available to the public or turn off archiving entirely. '''Archives are not searchable.'''

	By default, anyone can subscribe to the list. (To ensure that someone can't subscribe someone else as a prank, Mailman sends a confirm email message to the users asking something like, "You have been subscribed to.... Are you sure you want to subscribe? Just REPLYing to this message will subscribe you")		===General Settings===
			Most of the defaults for lists are probably fine but a number of them bear special mention.
	~~If this isn't~~ the ~~behavior you want, click "require approval" or "confirm+approval". Approval means that you, as the list administrator, will get~~ a ~~message saying USER@HOST wants to subscribe. You can then approve or discard their request.~~

	~~Again, on the bottom~~ of ~~the page, click "Submit Your Changes".~~

	By default, only list members can see the email addresses of other list members. '''Users can hide their own addresses from their list subscription page'''. Likewise, you can hide some users and not others from the Administrators Membership Management page.

	~~On the bottom of the page, click "Submit Your Changes"~~.

	~~You~~ can ~~decide to approve all posts rather than allowing~~ list ~~members~~ to ~~post by clicking~~ "~~yes~~" on the ~~fifth item~~ of the ~~privacy~~ page~~, "Must posts be approved by an administrator?" This means~~ that ~~all posts sent to~~ the list ~~will go~~ to ~~you first~~. ~~You~~ need to ~~either discard or allow them thru~~. ~~This~~ can ~~be done~~ on the "~~Tend to pending administrative requests~~" page.		Options under ''Subscribing'' under "Privacy options":
			* By default, no one can see the list. If this is not the behavior you want, change the setting on the first item "Advertise this list when people ask what lists are on this machine?" from NO to YES, and then "Submit Your Changes" on the bottom of the page. Note that even if users can't see the list, they can still subscribe (or try to subscribe). They simply need to know the URL.
			* By default, anyone can subscribe to the list. (To ensure that someone can't subscribe someone else as a prank, Mailman sends a confirm email message to the users asking something like, "You have been subscribed to.... Are you sure you want to subscribe? Just REPLYing to this message will subscribe you"). If this is not the behavior you want, change the setting on the second item "What steps are required for subscription?" and click "Require approval" or "Confirm and approve" and then "Submit Your Changes" on the bottom of the page. Approval means that you, as the list administrator, will get a message saying USER@HOST wants to subscribe. You can then approve or discard their request.

	list ~~(Not even~~ members ~~will be able~~ to ~~post)~~		Option under ''Membership exposure'' under "Privacy options":
			* By default, only list members can see the email addresses of other list members. '''Users can hide their own addresses from their list subscription page'''. Likewise, you can hide some users and not others from the Administrators Membership Management page. If you want to broadly change visibility for all users, change the setting on the first item "Who can view subscription list?" and click either "Anyone" or "List admin only" and then "Submit Your Changes" on the bottom of the page.

	===Moderated Lists===		===Moderated Lists===
Line 62:		Line 59:
	If you are a moderator for a list and want to view the queue of messages pending moderation, go to:		If you are a moderator for a list and want to view the queue of messages pending moderation, go to:

	http://lists.umiacs.umd.edu/mailman/admindb/LISTNAME		http://lists.umiacs.umd.edu/mailman/admindb/LISTNAME

	Please note that either the administrator password or a separately-set moderator password will work here. This is to allow moderators to perform their responsibilities without giving them full control of a list.		Please note that either the administrator password or a separately-set moderator password will work here. This is to allow moderators to perform their responsibilities without giving them full control of a list.