Email Settings

Overview

Email Settings control how UniSignIn sends emails to your readers and whether they arrive. They apply to system emails, such as sign-in codes and welcome emails, and to your own email templates and campaigns.

Go to Features > Email Settings. There are four tabs:

Tab	What it does
Sending	Open and click tracking, link parameters, marketing consent and your email provider.
Domains	The sender and tracking domain for all projects or for each project.
Deliverability	DNS checks for the domains you send from.
Suppressed	Addresses UniSignIn no longer sends to.

Email provider

Without a provider of your own, emails are sent through UniSignIn's sending service. Connect your own provider so emails come from your domain and land in the inbox.

On the Sending tab, turn on Enable custom email server and choose SMTP Provider, Amazon SES or Mailgun. Only one provider can be enabled at a time.

SMTP Provider

Use any email service that supports SMTP.

Setting	Value
From	The sender address and name, e.g. [email protected]
Host	Your SMTP server, e.g. smtp.example.com
Port	Usually 587
Username and Password	Your SMTP credentials
Enable	On

Amazon SES

Setting	Value
From	A sender address verified in SES, and a name
Access Key Id and Secret Access Key	An AWS key that is allowed to send email with SES
Region	The AWS region of your SES account
Enable	On

Mailgun

Setting	Value
From	The sender address and name
Sending domain	The domain verified in Mailgun, e.g. mg.example.com
Region	US or EU, where your Mailgun account is hosted
API key	A Mailgun sending API key for this domain
Webhook signing key	From the Webhooks page in Mailgun. Needed for bounce and complaint handling, see below.
Enable	On

Keys and passwords are stored encrypted. Click Save Changes.

Test it

Click Send Test Mail. A test email is sent to your own address through the provider, so you can check the settings before readers receive anything.

Domains

The Domains tab has a row for All projects and one for each project. A project uses its own settings when they are set, otherwise those for all projects.

Setting	What it does
Sender	The address and name emails are sent from. Without one, All projects uses the default sender of your email provider, and a project uses All projects. Click Save.
Tracking domain	Your own domain for tracked links and open tracking, e.g. track.example.com. Without one, the UniSignIn tracking domain is used.
Mailgun sending domain	Shown when your provider is Mailgun. The Mailgun domain the project sends through, see below.

The SPF and DMARC results for each sender show below it.

A Mailgun domain for each project

With Mailgun, each project can send through its own domain in your Mailgun account, for example when your projects are different brands.

1. Add and verify the domain in Mailgun, e.g. mg.brand-b.com.
2. On the Domains tab, enter it under Mailgun sending domain for the project and click Save. UniSignIn checks that the domain is in your Mailgun account.
3. In Mailgun, add the bounce and complaint webhooks to the new domain too, see With Mailgun. The webhook signing key stays the same.

Leave the field empty to use the All projects domain, or the Sending domain of the Mailgun provider.

Set up a tracking domain

1. Enter a subdomain you own, e.g. track.example.com, and click Set up.
2. Add the DNS records shown at your domain provider. If your domain uses Cloudflare, set the CNAME record to DNS only.
3. Click Check status. The domain changes from Pending to Active once the records are found. DNS changes can take up to an hour.

Click Remove to go back to the UniSignIn tracking domain.

Deliverability

The Deliverability tab checks the DNS records of each domain you send from.

Record	What is checked
SPF	A record exists. With Amazon SES, it should include amazonses.com, or use a custom MAIL FROM domain in SES. With Mailgun, the record is checked on the Mailgun sending domain and should include mailgun.org.
DKIM	Can't be checked automatically, so it shows Manual. Check it in your email provider.
DMARC	A record exists, and which policy it uses. A none policy only monitors.

Fix any record marked Missing or Check with your DNS provider, so your emails are not marked as spam.

Suppressed addresses

The Suppressed tab lists the addresses UniSignIn no longer sends to, with the Reason and the date each was Added:

Reason	When it is added
Bounce	An email to the address bounced permanently.
Complaint	The reader marked your email as spam.
Unsubscribed	The reader used the inbox's one-click unsubscribe on an email that isn't a campaign. See One-click unsubscribe.

Security emails are always sent, so readers can still sign in: One time password, Change password and Verification Link.

Type in Filter by email to find an address. Click Remove next to an address to send to it again, for example after the reader fixes their mailbox.

Bounces and complaints

UniSignIn suppresses an address automatically when your provider reports a permanent bounce or a spam complaint. Bounces and complaints also show in email activity, campaign results and Analytics.

Temporary failures, such as a busy server, are retried automatically and don't suppress the address.

Provider	How bounces and complaints reach UniSignIn
SMTP Provider	When the SMTP server refuses an address as unknown while sending, the address is suppressed right away.
Amazon SES	Through Amazon SNS, see below. This doesn't work when you send through SES with SMTP Provider.
Mailgun	Through Mailgun webhooks, see below.

For Amazon SES and Mailgun, the provider form on the Sending tab shows the address to send reports to, under Bounce and complaint notifications. Copy it from there.

With Amazon SES

1. In the AWS console, open Amazon SNS in the same region as your SES account. Create a topic of type Standard.
2. In the topic, create a subscription. Set Protocol to HTTPS and Endpoint to the address shown under Bounce and complaint notifications in the Amazon SES form. Leave Enable raw message delivery off. UniSignIn confirms the subscription automatically and its status changes to Confirmed.
3. In Amazon SES, open the verified identity you send from. Under Notifications, set the SNS topic for Bounce feedback and Complaint feedback. If you use a configuration set, you can add an event destination for Bounces and Complaints to the same topic instead.

To test it, send a test from any email template to [email protected] and another to [email protected]. Their activity shows Bounced and Spam complaint, and both addresses appear on the Suppressed tab. Click Remove to clear them.

With Mailgun

1. In Mailgun, open Webhooks for your sending domain.
2. Copy the webhook signing key into Webhook signing key in the Mailgun form and click Save Changes. UniSignIn uses it to check that reports come from Mailgun.
3. Add a webhook for Permanent Failure and one for Spam Complaints, both with the address shown under Bounce and complaint notifications in the Mailgun form.

One-click unsubscribe

Every email except security emails carries a one-click unsubscribe header. Gmail, Yahoo and other inboxes show it as Unsubscribe next to the sender.

• On a campaign email, it turns off the reader's marketing consent for that project, so they get no more campaigns.
• On any other email, it adds the address to the Suppressed tab with the reason Unsubscribed.

Security emails (One time password, Change password and Verification Link) and test emails don't carry it.

The unsubscribe and preferences links in your email footer still work. They open the reader's email preferences, where they can change each subscription.

Marketing consent

Campaigns only send to people who said yes to marketing emails. Under Marketing consent on the Sending tab, choose the consent field for each project.

The list offers the yes/no fields marked as Email subscription status in Data Management > User Data > Data Schema, see Profile Fields. Choose Not set to stop campaigns for a project.

Open and click tracking

Turn on Track opens and clicks on the Sending tab. UniSignIn then adds an invisible image to record opens, and sends links through a redirect to record clicks. Opens and clicks show in email activity, campaign results and Analytics.

Security emails are never tracked.

Link parameters

Link parameters are added to every link in your emails, so visits from email show up in your web analytics.

Setting	Example
utm_source	newsletter
utm_medium	email
utm_campaign	{{campaign.name | default:"email"}}, the name of the campaign sending the email
utm_content	footer
utm_term
Add unis_eid	Adds an ID, so a visit can be traced to the email it came from

Leave a parameter empty to leave it out. Values can use merge tags, e.g. {{profile.plan}}. Links that already have a parameter keep their own value. Click Save.

An email template can set its own link parameters instead, see Email Templates.

Edit the emails

Change the wording, design and branding of your emails in Email Templates.