Skip to contentSkip to navigationSkip to topbar
On this page

How to set up link branding



DNS

dns page anchor

DNS stands for Domain Name System. This is a naming system for domains on the internet. When SendGrid refers to your DNS, we are talking about your domain name that you want to send emails from, or that you want to link images from. When we talk about your DNS provider, we are talking about the service that hosts your domain name. For example, GoDaddy, Rackspace, or Cloudflare. For more information about DNS, see our DNS glossary page.

A CDN (content delivery network) is a network that delivers the content of webpages to the end user. The network selects the servers for delivery based on the location of the end user, the originating location of the webpage and the location of the content delivery server. Content Delivery Networks are a great mechanism that you can use to serve up content very quickly and easily across multiple mediums as well as handle security certificates for you.

We suggest CloudFlare, Fastly, or KeyCDN when using Content Delivery Networks with SendGrid.

The CNAME record creates an alias for subdomain.yourdomain.com and points to sendgrid.net. The CNAME is needed for our click and open tracking features in order for those statistics to be routed back to your SendGrid account. This will also be what your messages are signed by, so your recipients will be able to see what you have chosen for your CNAME. You set up the CNAME files that SendGrid provides with your DNS host. For more information about CNAME, see our CNAME glossary page.

To set up link branding, you must submit the DNS records provided by SendGrid to your DNS or hosting provider (for example, GoDaddy, Hover, CloudFlare, etc.). First, figure out who your hosting provider is and if you have access. If you don't have access to your DNS or hosting provider, you should figure out who in your company has this access before you begin setting up link branding.

(information)

Info

Note that you can also set up link branding when you set up your domain authentication, and you may not need to set it up again.

To set up and verify link branding:

  1. In the SendGrid UI, select Settings > Sender Authentication(link takes you to an external page).
  2. In the link branding section, click Get Started.
  3. Next, add in information about your DNS host. Click Next.
  4. Enter the domain that you want to brand the links and images with and add advanced settings. Make sure that you only enter the name of your root domain. Do not include www or http://www in this field. Your domain needs to match the domain of your from address on the emails you are sending out. For example, if I am branding with the domain example.sendgrid.com, I would set my link branding domain to be sendgrid.com. Click Next. For more information about advanced settings, see Advanced settings.
  5. Next, you need to add all the CNAME records on this screen to your DNS host. This process varies depending on your DNS host. Please see your host's documentation for details about working with their interfaces.
(information)

Info

A recent change with how GoDaddy handles new DNS record values automatically adds your domain, resulting in a CNAME entry with too much information and a failure when trying to complete Link Branding. An example of this would be url1234.yourdomain.com.yourdomain.com.

Below is an example of the CNAME values under the HOST column as they are displayed in step 5 and how you will need to enter into your GoDaddy DNS Management:

HOST/NAME url1234.yourdomain.com ENTER CNAME RECORD HOST/NAME AS: url1234 HOST/NAME 1234567.yourdomain.com ENTER CNAME RECORD HOST/NAME AS: 1234567

Entries made in the VALUE or POINTS TO field do not need to be changed.

(information)

Info

When configuring CNAME records in CloudFlare, check the bottom of the DNS settings page and make sure "CNAME Flattening" is set to "Flatten CNAME at root".

Now links and images in your emails are from your custom domain. You only need to update your link branding if you want to update the domain that appears in the links in your email.

It can take up to 48 hours for the records to verify after you upload them into your DNS host, so you will likely have to come back later to verify.

Once you add the CNAME records to your DNS host, return to the Sender authentication page(link takes you to an external page) and click Verify.

(information)

Info

If you click verify, and only half of your CNAME records verify, this usually means that you need to wait a bit longer. It's also possible that you entered one of your records in incorrectly. For other troubleshooting information, see Sender authentication troubleshooting.

Any time that you send an email with image or links that match the branded link, SendGrid applies that link to your email. You only need to update your link branding if you want to update the links used in your emails.


By assigning an authenticated domain to one of your subusers, you can give them the benefit of improved authentication and security, but also separate from the sending reputation of your parent account. If you assign a subusers domain, they can't edit or delete it.

To assign an authenticated domain to a subuser:

When authenticating a domain, open the Advanced Settings on the Authenticate Your Domain screen. Select Assign to a subuser, and assign a subuser to that domain. In order to pin subusers to the EU region, you must select the "Make domain EU-pinned" option.


Migrating from legacy Whitelabel

migrating-from-legacy-whitelabel page anchor

If you authenticated a domain (whitelabel) before 2015, your domain will still work. However, if you need to change or update it, you need to delete it and recreate it as an authenticated domain in our new system. If you do set up a new branded link, make sure to keep the same subdomain for domain authentication, but then use a different one for link branding.

If you set up a whitelabel after 2015, it has been automatically migrated to our new sender authentication system.


Need some help?

Terms of service

Copyright © 2024 Twilio Inc.