FreeLists Recommended Configuration

This page contains recommended configurations for mailing lists. These are general guidlines; you don't have to stick to them, but they'll certainly improve the general quality of your list. This guide is broken up into pieces according to what type of list you're running. We assume here that you're familiar with the Web interface-- if you need help with that, please see our other help documents. For options that every list should have but we've left up to you, see the bottom of this document.

A note about list types (list modes)

In general, there are three types of lists: Open Discussion, Moderated, and Newsletter-style (Note that there are several "subtypes" though, and depending on how you mix and match your configuration, you can draw the lines elsewhere.):

  • » Open: Anyone can post at anytime, and they don't have to subscribe first. Setting a list up like this is just begging for SPAM and other forms of rot, so we won't even discuss them.
  • » Moderated: Like Subscriber-only, but any message that a subscriber sends in first goes through the moderator for approval. This is ideal for large lists and those that would otherwise have uncontrolable volume. This is also great if you want a "newsletter" style list, but want to at least have the chance to pass your subscribers' posts to the list.
  • » Newsletter-style: This is like the Moderated list setup, but posts to the list are automatically denied. This setup is ideal for distribution and newsletter lists (of course).

The Open Discussion list

We'd like our list to accept posts from every user by default, yet still keep out people who aren't subscribed. Note that this is the default configuration for all lists at FreeLists, so you shouldn't have to change anything. We set the following options:

  • » Make sure Default-flags has at least |ECHOPOST|. Note: Separate flags with post symbols (|), and make sure you begin and end the string of flags with one post (|).
  • » Turn Closed-post on. This prevents outsiders from posting.

The Moderated list

We want to allow people to post, but we want to make sure their posts are legit first. To accomplish this, we have all messages routed through the moderator(s) for forwarding to the list. To start, follow the configuration steps for the Subscriber-only list.

  • » Set 'moderated' to on/true.
  • » Check on the following variables: admin-approvepost, moderate-include-queue, moderate-notify-nonsub, verbose-moderate-fail, and moderator-approvepost. Most of these are fluff, but they're nice to have available.

The Newsletter list

We want to setup a list that allows the moderator to post, but no one else. To do this, we set the default-flags setting to "|NOPOST|" plus whatever other flags you'd like each user who subscribes to have. Note: this only affects users as they subscribe -- all current users on the list are unaffected by changes made to this variable -- just something to keep in mind if you decide to change the format of your list after people are already on it.

Things every list should have

These are things that every list owner should consider adding to the list configuration. These things make your list easier to use, and will make your job as the moderator easier in the end. All this stuff can be done right in the web interface, and that they only take a few minutes. Note though that for each option (except the webpage), you must first enable the appropriate option in the list's configuration.

  • » A footer-file: Believe it or not, having a 4 or 5-line footer attached to the bottom of every post can be quite helpful to list subscribers. Put in things like the name of the list, the list's webpage, a link to the archives, how to unsubscribe, and the moderator's email address.
  • » An intro-file: This file is made available to anyone who wants to find out general information about your list. Include things like list policies, topics, etc.
  • » A welcome-file: This file is emailed to new users when they subscribe. This can be the same thing as the intro-file.
  • » A FAQ-file, or a pointer to one. Put in here the frequently asked questions like "how do I subscribe?" and "how do I post?"

Some suggestions

This is just general stuff we thought you should know. Do with it what you will.

  • » Don't change the humanize-xxxx settings. These include humanize-mime and humanize-html, which allow attachments and HTML emails, respectively.
  • » List owners: don't unsubscribe yourself from the list. That may sound obvious, but it happens. If you unsubscribe yourself, you'll lose all of your nifty ADMIN privileges, which we'll have to add back in manually for you.
  • » Make your users aware of the services FreeLists has to offer. Let them know about the archives for example.
  • » Use Ecartis's bounce handling to your advantage. Ecartis has a lot of configurability when it comes to handling these things. It'll automatically unsubscribe people after a number of bounces that you specify, or set them VACATION instead, up to you. It'll send you reports so you can track bounces and unsubscribe problematic people manually.

If you have any questions about the content of this document, or come across anything you feel should be added to this document, please feel free to let us know.