Table of Contents

What is whitelabeling?

Whitelabeling allows you to better authenticate the email you send from your SendGrid parent or subuser account.

Before whitelabeling, all of your outbound emails will be marked as “mailed-by” and “sent-by” sendgrid.com. Any links in your emails with click tracking enabled will include sendgrid.net in the URL and the rDNS information for your sending IP address will point to SendGrid instead of your own domain.

While users sending through SendGrid without a whitelabel can still expect a very high delivery rate, whitelabeling is the best thing you can do to begin building trust with your recipients’ inbox providers.

The benefits of whitelabeling extend beyond pleasing inbox providers: creating IP, link and domain whitelabels will help you develop brand consistency and domain alignment— the domain in your FROM address will match the domain in the Return-Path, the domain in the DKIM signature, and the domain that your sending IP addresses point to.

Where can I find more information about whitelabeling?

You can find all of our whitelabel video tutorials here.

What are the benefits of whitelabeling subusers?

You should always strive to build and maintain a positive sender reputation. The sending reputation of your subuser accounts is just as important as the reputation of your parent account.

Whitelabeling your parent account will not benefit the reputations of your subusers. To improve your subusers’ reputations, you must create for them, or encourage them to create, their own whitelabels.

If you have multiple unrelated subusers who send different types of email, providing each subuser with their own whitelabel is an easy way to separate their sending reputations.

Creating Subuser Whitelabels

There are three ways to create a subuser whitelabel:

  1. You can create a whitelabel from your parent account, and then assign that whitelabel to a subuser via subuser management.
  2. You can create a whitelabel on behalf of a subuser from your parent account— connecting that whitelabel with the subuser.
  3. If you are a subuser, you may create and manage your own whitelabel if the parent account has not already assigned you a whitelabel.

Below you will find step-by-step instructions explaining each of these two options, along with a discussion of the pros and cons of each option.

The steps described below illustrate the processes of creating a subuser whitelabel for your sending domain. However, the same steps may be followed for link whitelabels.

Creating a Subuser Whitelabel from the Parent Account

Benefits of whitelabeling a subuser from the parent account

Whitelabels created by the parent account and assigned to a subuser can not be edited by the subuser. This is a secure and safe method that provides the parent account with more control over subusers’ whitelabels.

While subusers cannot modify whitelabels assigned or connected to them, they can still create their own whitelabel which would overwrite the whitelabel assigned or connected to them by the parent account.

Assigning a whitelabel to a subuser

Before you can assign a whitelabel to a subuser, you must first create the whitelabel on your parent account. Creating a domain whitelabel from your parent account is explained in detail here.

After you have created your new whitelabel, navigate to your Subuser Management page from the left hand side bar. Click on the subuser you would like to assign a whitelabel to.

Next to the Whitelabel Domain and Whitelabel Link options, click Change Sending.

Next, select the whitelabel you would like to assign to the subuser from either the Select a whitelabel domain or the Select a whitelabel link dropdown menu depending on the type of whitelabel you want to assign.

Finally, click Save. You should see the new whitelabel listed under either Whitelabel Domain or Whitelabel Link, depending on which whitelabel you chose.

Whitelabeling on behalf of a subuser

When creating your new whitelabel you are presented with a window where you specify the subdomain and domain of your new whitelabel. Above these fields, you will see a dropdown menu titled ON BEHALF OF USER.

To create a whitelabel for a specific subuser, select that subuser from this dropdown menu. You are connecting this whitelabel with this subuser and only this subuser will be able to use this whitelabel.

The remainder of the steps to create a domain whitelabel are explained here.

Creating a Whitelabel from the Subuser Account

The steps for creating a whitelabel as a subuser are no different from those for a parent account.

Step-by-step instructions explaining how to create a domain whitelabel can be found here.

If a parent account has already assigned or connected a whitelabel with your account, any new whitelabel that you create will overwrite the previous whitelabel if it is set as default.

Benefits of whitelabeling from a subuser account or on behalf of a subuser

SPF record benefits

Currently, SendGrid only will include up to 11 different IP addresses in an SPF record before we resort to using sendgrid.net ~all.

However, it is easy to ensure that the SPF record for a subuser includes only IP addresses assigned to that subuser. Simply create a whitelabel from the subuser account, or create a whitelabel on behalf of a subuser from the parent account.

DKIM key benefits

DKIM keys are specific to each SendGrid user. So, multiple whitelabels created by a parent SendGrid account will all share the same DKIM Key.

To ensure that your subuser has their own unique DKIM Key, create a whitelabel from the subuser account or create the whitelabel on behalf of that subuser from the parent account.

We recommend that OEM SendGrid users create whitelabels for their subusers on their subusers account or create the whitelabel on behalf of that subuser from the parent account. This will ensure that each subuser has their own DKIM Key and will prevent subusers from impersonating each other.