Brand or white label your Email notifications

Courier's Brands feature set lets you apply a consistent look and feel to your email notifications. You can also use this feature to "white label" email notifications you send on behalf of your customers to their end-user recipients or if you have multiple brands internally.

Courier Brands are also fully API enabled. Developers can get, create, update and delete brands programmatically using our Brands API.


Using your default brand

Your default brand, along with any custom brand, can be customized and renamed. The default brand cannot be deleted.

Customizing your default brand is important because

  • Every email notification you create uses the Default Brand unless you manually disable Brands in the Notification settings.

  • If you enable brands on a notification, your Default Brand will be the fallback for any Send API call that does not specify a brand in the user profile.

Creating a new brand

  • To create a new brand open the notification Designer, select Brands in the top menu and click 'New Brand.'

  • Giving your Brand an optional Brand ID will allow your developers to manage your brand programmatically using the Brands API.

Creating a new brand in the Courier Brand designer

Setting a custom brand as your default

To set a custom brand as your default, open the brand settings and click Set As Default.

How to open the brand settings
Setting a custom brand as the default in the brand settings

Customizing your Brands

Use the Notification Designer to customize a Brand

Using the Notification Designer you can create and customize your Brands in the following ways:

Use a Custom Template to create your brand look

If you prefer, you can use code to customize your Brand header and footer by selecting the "Use Custom Template" option in the Brand Designer.

Custom Templates combine the best of both worlds: allowing you to ensure brand consistency using Handlebars and HTML or MJML to customize the header, footer and email body background while using the drag & drop content designer to create the body of the email with content blocks that can be reused across channels.

The Courier brand designer custom email template Head, Header and Footer editor

Customize your Brand Template CSS

You can customize the <style> element in the <head> section of your Brands using custom templates as well as brands built using the Designer UI. Read more about Courier's CSS Classnames

Preview your Brand Enabled Email Notifications

To preview what your email notification will look like with different brands applied, open the Preview then select the Brand from the Preview Details > Brand menu.

Selecting a Brand in the email preview tab

Customizing your brand using variables

Any brand attribute you can customize in the brand designer UI, you can also set via variables like {{var ""}} for example.

Here is the schema for the brand information accessible via variables.

export const getBrandVariables = (
brand?: IBrand
): {
id?: string;
| {
primary: string;
secondary: string;
tertiary: string;
| {};
email?: {
header: {
barColor?: string;
logo: {
href?: string;
image?: string;
social?: {
facebook?: string;
instagram?: string;
linkedin?: string;
medium?: string;
twitter?: string;

Create custom, reusable code with Snippets

Snippets are pieces of handlebars code that you can copy and paste or pull into a Template Block using the snippet name.

Snippet code example

To use Snippets add a Template Block to an email Notification, simply call it using a Template Block: {{>snippet_name}}

Calling the snippet into a Template Block

Using the Notification preview allows you to see the Snippet rendered.

The Snippet rendered in preview

Customize your Snippet content using variables

You can use variables to pull customized content into the Snippet, supplying the value for the variable inside the user profile sent via the Send API call.

Brand snippet handlebars code showing how to set a value using a variable to pull in data from the send command's JSON data payload

Snippets and the default brand

If a snippet exists in the default brand, but not in a custom brand, the default brand snippet will render in the custom brand–as long as there isn't a snippet with the same name native to that custom brand.

This means you can put any or all of your snippets in the default brand and call them into multiple custom brands. Think of custom brands as extending the default. They can still have their own custom snippets as well.

Sending a branded Email Notification

  1. The Notification must be brand enabled in the Notification Settings

  2. Include a Brand ID in the Send API call (if no Brand ID is provided, Courier will send using the Default Brand. See the Send API documentation for details.

The Brand Config in screen in the notification settings is where you enable it to use email brands

Watch: Courier live: building and sending whitelabel emails via the Brands API

Did this answer your question?