Overview
A subdomain is a domain or DNS record that is added to a primary domain. For example, if your primary domain was example.com, you could add a subdomain to it named blog.example.com.
The 'blog' part in front of the primary domain is what makes it a subdomain. This is because domains are read from the right to left. In the example of blog.example.com, the three sections break down like this:
- .com — This is the top-level domain (TLD)
- example. — This is your unique domain name
- blog. — This is the subdomain
Two ways to add a subdomain
There are two ways to add a subdomain at DreamHost.
- As its own Fully Hosted subdomain — This means it will be its own unique website.
- As a Custom DNS record — This is only a DNS record that points away from DreamHost.
The following sections explain both methods.
Option 1 — Adding a Fully Hosted subdomain
Adding a Fully Hosted subdomain is the same as adding a primary domain. View the following article for full instructions:
When you add the subdomain, it is automatically added to the Manage Websites page under the primary domain. You can then host a new website on this subdomain.
If you receive the following error message:
You can't add that domain: you must add the parent domain example.com
to your account before adding a subdomain to it.
It means that the primary domain is not yet in the system. A subdomain can only be created if its primary domain is created first (example.com). This is necessary even if you don't plan on hosting the second-level domain at DreamHost.
Once the subdomain is set as Fully Hosted, an IP address is assigned. If your nameservers are not hosted with DreamHost you must point your A records to this IP.
View the DNS article for instructions on how to view this new IP address.
Option 2 — Adding a subdomain as a Custom DNS record
If you are hosting the primary domain at DreamHost (example.com), but want to host the subdomain at another company (blog.example.com), you should create a 'Custom DNS' record instead. This allows you to set the IP address of the subdomain to point to another hosting provider.
View the following article that describes how to add an 'A Record' as a custom DNS record. This is the same method you'll use to create your subdomain.
Propagation time
After the domain is added, the DNS must propagate. This can take 4-6 hrs. You can use either of the following links to confirm that the DNS has updated in your location:
- whatsmydns.net — A popular site that checks DNS records around the world.
- Viewing your DreamHost DNS records — Use DreamHost's DNS propagation checker in the panel.
Can I add an email for a subdomain?
Yes. Once the subdomain has been added to the Manage Websites page, go to the Manage Email section of your panel and proceed with the configuration steps detailed in the following article:
Other options for your subdomain
A mirror of a DreamPress site does not work in most cases due to DreamPress caching.
The above examples show how to create a subdomain that is Fully Hosted at DreamHost, or points to a different hosting company. There are also a few other ways you can use with a subdomain at DreamHost. For example:
- Redirect
- Mirrored
View the following articles for further information on how to configure these options: