Configuring a custom domain name for a Microsoft Azure Web Sites


I need to remember this for later. Therefore, I'll do a quick post about. I finally moved my web site to Azure WebSites. But now I want to register my custome domain of Some steps are missing for some docs I'm reading so I'll just document my jouney.


An Microsoft Azure account. You will have a domain registrar. My domain ( is registered with Network Solutions.

You also need a shared web site mode in place.


Shared mode for a web site

The bummer is that each domain registrar is slightly different. But this post will certainly lead you in the right direction.

Providing a custom domain

Starting at the Azure Management Portal

This post starts at your Azure Web Site where you've deployed your web app.

  1. Login into your portal account and navigate to Azure Web Sites. Select DASHBOARD from the top menu bar.


    Azure Management Portal - Azure Web Sites

  2. Select MANAGE DOMAIN.


    Selecting Manage Domains

  3. We need the IP address. In our case, it is Yours will be different. Copy it to the clipboard.


    Getting the IP Address

The Domain Registrar Portal

This could be one of many possible types. I am using the original Network Solutions but you may have GoDaddy or even someone else.

  1. Login into your domain registrar. Mine is Network Solutions. Perhaps yours is GoDaddy. So the user interface may not be identical. But the concept is the same.


    Managing your account

  2. Select EDIT DNS.


    Editing the DNS Settings

  3. It is time to edit the A Record. Now enter the IP address you obtained from the Azure portal for your Azure web site. Recall ours was

    Note: the A record is used to translate from a domain name to an IPv4 address.


    Editing the A Record

  4. It is time to edit the CNAME record.


    Editing the CNAME

    Note: A CNAME record maps a specific domain, such as or , to a canonical domain name. In this case, the canonical domain name is the either the domain name of your Windows Azure web site of your Traffic Manager profile. Once created, the CNAME creates an alias for the domain name. The CNAME entry will resolve to the IP address of your domain name automatically, so if the IP address of the web site changes, you do not have to take any action.

  5. This is what the finished CNAME record looks like.


    Verifying the CNAME records

Returning back to the Azure portal

You may need to wait a couple of hours before this works.

  1. You many need to wait a couple of yours before returning back to the Azure portal and finish adding the domain names.


    Entering in the domain name into the Azure Portal

  2. Notice the correct mapping of my domain name working.


    Verifying your domain name

  3. Of course, my unmapped, original Azure Web site name still works.


    Viewing the original Azure-assigned domain name


I hope this helps you. I spent way, way too much time figuring this out. That's why it is a post now.