How to Map a Custom Domain?

Everything you need to know about setting a Custom Domain for your blog on Hashnode.

Updated over a week ago

When you create your Hashnode blog, we provide you with a free subdomain that looks like "yourdomain.hashnode.dev". However, you can set up your own domain for your Hashnode blog, such as "yourdomain.tld", or a subdomain, such as "blog.yourdomain.tld".

Watch this quick video to see how to blog on your own custom domain on Hashnode:


In this guide, you will learn the steps of how to accomplish this alongside some additional specific guides for different domain DNS providers.

Step 1: Log into your Hashnode account.

Step 2: Click on your profile picture at the top-right corner of the page on a desktop or mobile screen.

Step 3: Next, click on the Manage your blogs option to access your personal and team blogs.

Attachment Frame 2.png

Step 4: Select the Dashboard of the blog you want to update

Attachment Frame 2.png

Step 5: Click on the "Domain" tab visible on the left-side panel.

Attachment Frame 2.png

Step 6: Navigate to the "Custom Domain" tab and enter your domain without the "www" or "https://" prefix in the text field provided. Then click on the "Update button" to proceed.

Step 7: From the popup, select if you want to use the "www" and redirect it to the "non-www" version (apex domain) or not.

Step 8: Head over to your DNS provider and add an "A record" for your apex domain at the root whose hostname is "@" with a value of "76.76.21.21".

Step 9: Add a CNAME record for the WWW of your domain, where the hostname is "www", and the corresponding value is "hashnode.network". This CNAME record will point your domain or subdomain to Hashnode's IP address.

⚠️ Using the CNAME record at the root level (e.g., yourdomain.tld) is not recommended unless your DNS provider supports CNAME flattening as this will affect your domain's MX records and email service.

Step 10: When your domain is successfully mapped and ready, you will see three green icons as shown below:


Still not sure if your DNS provider supports CNAME flattening or when to use CNAME or A record? Here's a quick summary to guide you:

  • If you are setting up your blog at the root level (e.g. yourdomain.tld), use A record.

  • If you are setting up your blog on a subdomain (e.g. blog.yourdomain.tld), use the CNAME record.


Below is a table showing the most popular DNS providers and what type of domain record they support:

DNS Provider

Supports CNAME Flattening

Use CNAME Record (Root)

Use A Record (Root)

Namecheap

No

-

Cloudflare

Yes

-

GoDaddy

No

-

OpenDNS

No

-

Oracle Dyn Managed DNS

No

-

Cisco Umbrella

No

-

Amazon Route 53

No

-

Google Cloud DNS

No

-

Hostinger

No

IBM Domain Name Services (DNS)

Yes

-

Azure DNS

Yes

-

Next Read:


💡 Tip

Need more help? Get support from the Hashnode Community on Discord.
Find answers and get help from our Intercom Support and Hashnode Experts


Did this answer your question?