All project content is available for reading, but you need to be a member of the project for Subversion checkout of source code, or to create/modify any information.
Login if you are a member. Apply here to request membership (open to all).

Newsletter User Guide

How to use the Newsletter module.

Getting Started

This is a screenshot from the Getting Started guide shown when the module has been installed:
Getting Started Screenshot

Mailing List Quality

When sending bulk emails like in the Newsletter module, the quality of your recipient list is extremely important to ensure a high delivery rate, and avoiding your domain and IP to be blacklisted. Once you’re blacklisted it is hard to get off the lists, and earn trust again.

The Newsletter module basically operates in two modes:

1. Collect emails during a sign up form

You have a sign up form, and use opt-in to verify the email address. The newsletter has an example block for registering emails that you can use. In addition, it does simple server-side validation of the address.

If you’re using the Mailgun sender, the email will be validated against the Mailgun validation service before being accepted.

These emails will be added to a Recipient list that you can later use for emailing. You can have several recipient lists if you want to target different messages to different people (the same emails can be on more than one list).

2. Import emails in bulk

If your newsletter recipients typically come from an external registry as a CRM system or a paid service, you have a much higher risk of being blacklisted and end up in spam filters due to the inherit low quality of these list. Every email list will deteriorate over time, and you need to keep it clean.

When using Mailgun as your sender, it will protect it’s own (and your) sender reputation, and stop your emails if the list quality is low. This is actually a good thing, and helps prevent both you and Mailgun from being banned by email service providers. In addition to preventing you from hurting yourself, Mailgun will also throttle the email sending according to best practices and knowledge about how the different ISPs maps email volume to spam.

If you’re using regular SMTP sending, there is nothing protecting you from attempting to send to a bad mailing list. You will likely get a lot of bounces, which might already have hurt your reputation with the ISPs. If you do not act on the bounces, and keep sending to the same recipients, you’re setting yourself up for trouble.

If you are importing emails as a one time job, there are several online email validations that will help you wash the list for a reasonable sum. Beware - do not use the free services - they are typically of low quality, and more importantly, they might steal your addresses and sell them to spammers. The quality services will do more than just MX lookups, and have custom checks in addition to just asking the email domain if it knows the address (which many will deny to prevent spam anyway).

Expect to pay up to USD10 per 1000 emails.

Example email validators:

Using the Block Lists

The EPiCode Newsletter module has a Block List feature, which is just a list of emails, that you can use to filter your recipient lists prior to sending the email.

Make sure you add bounced email addresses to the block list. While Mailgun will block hard bounces itself, soft bounces will be retried for a few hours, and then failed, but not added to the bouncelist for future exclusion.

You can also add email addresses of users that have complained, or asked to be manually removed from all lists to prevent that they never recieve newsletters ever again.

Note! You are responsible for filtering the newsletter email addresses before actually sending the newsletter.


Remember - the Newsletter Module is free, if you have contributions, that being documentation or code, any feedback is very much appreciated. Please use our ticket system to help us out:

Ask a question

Requires login.

Report a bug

Requires login.

Add a feature request

Requires login.