Revision as of 17:21, 17 December 2021

Composing a Mass Mailing

The Mass Mail Tool allows the sending of an email message to a group of clients ranging from every client on file to those who meet specific criteria.

• Begin by going to Clients > Mass Mail Tool
• You can then choose the criteria you want to filter on in order to select who the email will be sent to
• By default the email type is General and so you can only filter on the client status or country criteria
• If you want to filter on product related criteria you must ensure you set the Email Type to be Product/Service related
• Likewise if you want to filter on domain related criteria you must set the Email Type to be Domain related
• If you do not want to filter clients by a specific criteria then leave that filter unchanged and it will be ignored.

Please Note: When composing the email you will see the full list of clients matching your selected criteria in the To field. This is so you can review who will be receiving it but each email is sent individually and so the receiver will not see any other client's addresses in the To field of the copy they receive.

Filtering by Country

As of Version 7.5, you now have the ability to send mass mailings to only clients in specific countries. To do this, you can simply select the countries in which you want your clients to receive the notices as shown below.

Marketing Email

It may not be desirable to send certain emails to all clients, therefore if you have enabled the Marketing Opt-Out feature in General Settings, check Marketing Email to prevent this email being sent to clients who have chosen not to receive marketing emails.

If this email is an important announcement that should be received by all clients in your mass-mail criteria, do not check this option.

Contacts

Contacts can be used to send a copy of a message to a different email address. When you send one-time or mass mails, contacts and sub-accounts with the General email notification option enabled will receive a copy of any General mass mails for to the master account holder.

If the contact has the Product email notification option enabled, they will receive copies of mass mails with the Product/Service email type. Contacts with Domain email notifications enabled will receive a copy of Domain type mass mails.

Contacts won't be listed in the recipients list when composing the message, but if their master account is listed and they have the appropriate email permission, they will receive a copy.

Copy Emails

The CC and BCC options allow a copy of each individual mass mailing email to be sent to additional email addresses. Multiple email addresses can be entered by separating each address with a comma.

These fields are not designed for adding additional recipients to the existing list.

Batch Processing

When sending to a large number of recipients, WHMCS will automatically break the sending into batches of 25 emails every 30 seconds. However as of Version 4.5, you can customise this and change both the number and frequency with which they send when composing your email message.

Mailing Lists

It is possible to create a mailing list using custom client fields. Navigate to Configuration () > System Settings > Custom Fields or, prior to WHMCS 8.0, Setup > Custom Client Field and create one called Mailing List (just as an example). You can use Dropdown or TickBox fields. If choosing Dropdown, make certain to enter the Select Options "Yes,No".

Now on the mass mailing page this will appear as a client filter option, so you may send emails only to clients who have chosen to receive these mailings.

Common Problems

No Recipients

The criteria selected for this email has resulted in no recipients which means it cannot be sent. Meaning there are no clients meeting the criteria selected on the mass mail page, go back and select a different set of criteria. Most commonly this is caused by selecting a client group or language to which no clients are assigned.