Skip to content

Email Preferences

Email Preferences is where you can set specific outbound email settings like custom footers, custom opt-in and opt-out pages, and more. Including these options in your outbound emails make for a fluid and cohesive experience for your users.

Email Preferences can be found under Settings in the dashboard.

Sending configuration

The email settings under the Sending Configuration section determine which details are included in your email campaigns. In particular, these settings are mainly related to what your user sees when they receive an email from Braze.

Outbound email settings

When configuring your email settings, your outbound email settings identify which name and email addresses are used when Braze sends emails to your users.

In this section, you can add the names and email addresses that can be used when Braze sends emails to your users. The display names and email addresses will be available in the Edit Sending Info options as you compose your email campaign.

When setting your “From” addresses, make sure your “From” email domain matches your sending domain (i.e., Failure to do this may result in SPF and DKIM misalignment. All reply-to emails can be set to your root domain.

Adding an email address in this section allows you to select it as a reply-to address for your email campaign. You can also make an email address the default one by selecting Make Default. These email addresses will be available in the Edit Sending Info options as you compose your email campaign.

This section allows you to add and manage BCC addresses that can be appended to outbound email messages sent from Braze. Appending a BCC address to an email message will send an identical copy of the message your user receives to your BCC inbox. This is a useful tool to retain copies of messages you sent your users for compliance requirements or customer support issues.

BCC Address section of the Email Settings tab.

Once you add an address, the address will be made available to select when composing an email in either campaigns or Canvas steps. Select Make Default next to an address to set this address to be selected by default when launching a new email campaign or Canvas component. To override this at the message level, you can select No BCC when setting up your message.

If you require that all email messages sent from Braze have a BCC address included, you can select the Require a BCC address for all your email campaigns toggle. This will require you to select a default address which will be automatically selected on new email campaigns or Canvas steps. The default address will also be automatically added to all messages triggered through our REST API. There is no need to change the existing API request to include the address.

Open tracking pixel

Braze Learning course

The email opening tracking pixel is an invisible 1 x 1 px image that automatically gets inserted into your email HTML. This pixel helps Braze detect whether the end-users have opened your email. Email open information can be very useful, helping users determine effective marketing strategies by understanding the corresponding open rates.

Placing the tracking pixel

Braze’s default behavior is to append the tracking pixel to the bottom of your email. For the majority of users, this is the ideal place to put the pixel. While the pixel is already styled to cause as few visual changes as possible, any unintentional visual changes would be the least visible at the bottom of an email. This is also the default for email providers such as SendGrid and SparkPost.

Changing location of tracking pixel

Braze currently supports overriding the ESP’s default open tracking pixel location (the last tag in the <body> of an email) to move it to the first tag in the <body>.

To change the location:

  1. In Braze, go to Settings > Email Preferences.
  2. Click the checkbox under Custom Open Tracking Pixel Settings.
  3. Press Save.

Once saved, Braze will send special instructions to the ESP in order to place the open tracking pixel at the top of all HTML emails.

Include a list-unsubscribe header

This feature allows you to automatically include a list-unsubscribe header for emails sent to subscribed or opted-in users. This header allows email providers to include an Unsubscribe button when displaying an email.

Some recipients prefer to have an unsubscribe link available in the same place for all emails, rather than having to find links in each mailing. When enabled, this feature puts a prominent unsubscribe link in the header of the email, making it easier to unsubscribe and, therefore, helps reduce the likelihood that a user would mark your email as spam. This can have a significant impact on your reputation and deliverability as an email sender.

How the list-unsubscribe header works

When enabled, this feature is applied to the entire workspace. Braze will add a standard list-unsubscribe “mailto:” header to all eligible outgoing emails. This list-unsubscribe header is not customizable. Upon receiving a list-unsubscribe request from a user, Braze will ensure this user is unsubscribed. If there is no match, Braze will not process this request.

Option to automatically include a list-unsubscribe header for emails sent to subscribed or opted-in users.

Note that the header is not added for messages targeting all users including unsubscribed users, as these represent transactional messages which do not need an unsubscribe function.


Currently, only Windows Live Hotmail and Gmail support the list-unsubscribe header. Additionally, these ESPs may still choose not to provide you with this feature if you haven’t completed IP warming yet, or if you are a new sender. This is because providers like Gmail won’t include the unsubscribe option if they can’t trust that you’ll actually unsubscribe the user.

Append email subject lines

Use the toggle to include “[TEST]” and “[SEED]” in your test and seed email subject lines. This can help identify any email campaigns sent as tests.

Inline CSS on new emails by default

CSS inlining is a technique that automatically inlines CSS styles for your emails and new emails. For some email clients, this can improve the way that your emails render.

Changing this setting will not affect any of your existing email messages or templates. You can override this default at any time while composing messages or templates. For more information, refer to CSS inlining.

Resubscribe users when their email changes

You may automatically resubscribe users when they change their email address. For example, if a previously unsubscribed workspace user changes their email address to one that is not on Braze’s unsubscribe list, they will automatically become resubscribed.

Subscription pages and footers

Braze lets you set a Custom Unsubscribe Page with your own HTML. This page will appear once a user has selected to unsubscribe from the bottom of an email. Note that this page should be less than 750 KB.

Learn more about best practices for email list management in Managing email subscriptions.

You can create a custom opt-in page using your own HTML. Including this in your email can be especially beneficial if you want your branding and message to remain consistent throughout your user lifecycle. Note that this page should be less than 750 KB.

Learn more about best practices for email list management in Managing email subscriptions.

New Stuff!