Mail Classes

GreenArrow Engine’s SimpleMH system classifies mail into Mail Classes. Each message that’s processed by SimpleMH is assigned a Mail Class, which is used to determine which SimpleMH Mail Features to use.

A comparison of SimpleMH and Raw Injection can be found in the Injecting Mail page.

SimpleMH’s headers are described in the SimpleMH Headers page.

Table of Contents
Mail Class Selection Precedence
Adding a Mail Class
Editing a Mail Class
Mail Class Attributes

Mail Class Selection Precedence

There are multiple methods available for specifying which Mail Class a message will use. When multiple methods are used for the same message, the first match in the following list is used:

The X-GreenArrow-MailClass header
The GREENARROW_MAILCLASS environment variable (either in an IP relay authorization or passed as a variable while using a local injection option
SMTP AUTH username matching
$DEFAULT_MAILCLASS_SUB in SimpleMH’s configuration file
$DEFAULT_MAILCLASS in SimpleMH’s configuration file

Adding a Mail Class

To add a Mail Class to GreenArrow Engine’s configuration, complete the following steps:

Login to the GreenArrow Engine Web Interface.
Navigate to Configure => Mail Classes:
Click the Add Mail Class button:
In the New Mail Class form, complete the form and click Save. See reference below for details about mail class attributes.

Editing a Mail Class

To edit an existing Mail Class, complete the following steps:

Login to the GreenArrow Engine Web Interface.
Navigate to Configure => Mail Classes:
Click the Edit button next to the Mail Class that you wish to edit:
Fill in the form, then click Save. This form’s fields are described in the section below.

Mail Class Attributes

Name
string

The name that you wish to assign the Mail Class. This is the value that you’ll be able to use later when including the X-GreenArrow-MailClass header in messages belonging to this Mail Class. The following rules apply to Mail Class names:

Names may consist of letters and underscores.
The “a” Mail Class is reserved and may not be created.
Two or more underscores may not appear next to each other. For example, “server__a__email” is invalid, but “server_a_email” is valid.
The name length can not exceed 64 characters.
Please see the Bounce Processor Concepts documentation for caveats regarding long mail class names.

Virtual MTA
selection list

The VirtualMTA to assign mail in this Mail Class to.

Mailing List ID
string

The ListID to assign mail in this Mail Class to

Bounce Address
selection list

The Bounce Address to use for mail in this Mail Class. The list contains:

Bounce Mailboxes defined in Incoming Email Domains and Aliased Email Domains
Any bounce addresses configured via the bounce_address_external directive in the main configuration file

BCC All Messages
enabled/disabled

Add a BCC to every email sent using this Mail Class.

Add Custom Headers
enabled/disabled

Add custom X- headers to emails sent using this Mail Class.

A maximum of 1024 bytes are allowed.
Only headers beginning with X- or is List-Help may be entered.
The only X-GreenArrow headers allowed are (see SimpleMH Headers for usage)
- X-GreenArrow-DKIM
- X-GreenArrow-DKIM-Only-Using-Domain
- X-GreenArrow-Signing-Selector

Add Message-ID if missing
enabled/disabled

If the injected message does not include a Message-ID header, one will be generated automatically.

Track Clicks and Opens
enabled/disabled

Turns click and open tracking on or off for this Mail Class.

Handle Unsubscribe Links
enabled/disabled

Turns unsubscribe link processing on or off for this Mail Class.

Pass Bounce Messages Through
enabled/disabled

Send a copy of each bounce message back to the original Return-Path recipient. Engine will still process the bounce locally when using this feature.

If you enable this feature, make sure that the original Return-Path domains have throttling configurations in place which allows Engine to deliver these bounces as quickly as they come in. Otherwise, the bounce pass through messages could fill up GreenArrow’s queues as they wait to be delivered. That situation has the potential to slow deliveries to a crawl system wide.

URL Domain
selection list

Choose the URL Domain to use in Click + Open tracking for mail sent via this Mail Class.

Archive a Sample of Messages
enabled/disabled

Archives sample messages to a table in GreenArrow Engine’s PostgreSQL database.

Disable Automatic List-Unsubscribe Header
enabled/disabled

If the injected message does not include a List-Unsubscribe header, one will be generated automatically. This option disables this behavior.

Automatically Seed Mailings
enabled/disabled

Causes SimpleMH to send sample messages belonging to this Mail Class to the GreenArrow Monitor seed list. Sends to addresses in GreenArrow Monitor’s seedlist occur once per Send, and are evenly distributed between the times that GreenArrow Engine receives the message numbers designated in the Number of emails to start seeding at and Number of emails to finish seeding by fields.

When this feature is enabled, GreenArrow Monitor groups all messages for this Mail Class into one campaign per Send. This takes precedence over the X-CampaignID header.

Number of Emails to Start Seeding At number	Set this field’s value to the daily message volume below which, you don’t want automatic seeding to take place. The field is hidden unless the `Automatically seed mailings` box is checked.
Number of Emails to Finish Seeding By number	Set this field’s value to the minimum number of messages that would be sent on a Send that automatic seeding occurs. If this field is set to a value that’s higher than the number of messages that are sent, then only a portion of the GreenArrow Monitor seedlist will be sent to. The field is hidden unless the `Automatically seed mailings` box is checked.

Convert Text-only Messages into HTML
enabled/disabled

Converts text only messages to HTML. If this box is checked, additional fields appear, which allow you specify an HTML header, HTML footer, the text that should appear for converted links, and regular expression operations to perform before, and after conversion to HTML.

Modify HTML messages
enabled/disabled

If this box is checked, additional fields appear which allow you specify how you’d like HTML messages to be modified.