Subdomains
A subdomain is a prefix that appears before the primary (or root) domain of a website. It's commonly used to create a distinct, organized section of an existing site that functions like its own website.
For example, if the primary domain is "authorwebsites.com" then "authorname.authorwebsites.com" would be a subdomain. In this case, "authorname" is the subdomain portion of the URL.
Although subdomains are technically part of the same root domain, they often behave like separate websites. They can have their own content, design, and access settings, while still being connected to the main domain.
Setting Up a Subdomain
When you create a new Bookshelf account, one of the first things you'll be asked to choose is how you want to publish your website.
The Bookshelf offers domains for purchase and hosting, with most domains included for free with all annual subscriptions. However, if you aren't ready to claim your own domain or don't already own one you'd like to connect, we also provide the option to publish your website using a Bookshelf subdomain.
Every Bookshelf subdomain follows the format "authorname.thebookshelf.io." Whatever you choose as the "authorname" portion of this example will always precede "thebookshelf.io." Your site will be hosted by The Bookshelf, but you'll still have full control over it through your Bookshelf account.
To get started, simply select “Use a Subdomain" when prompted during account setup, and enter the name you’d like to use. If you later decide to purchase a domain, you can do so at any time by navigating to “Domain & Email” in the left-side menu of your Bookshelf account, then follow the steps found at this article on purchasing a new domain.
Important Note About Subdomains
Subdomains cannot be transferred to another hosting provider. If you choose to not renew your Bookshelf account and your site is published only under a subdomain, you will lose access to that URL and the website attached to it.
If you register your own custom domain, even through The Bookshelf, you retain ownership of that domain and can use it with another hosting service in the future even if you choose to not renew your Bookshelf account.
When to Use a Subdomain
Choosing a subdomain does not need to be a permanent decision. If you’re unsure what custom domain name you want or would like to get started on building your website quickly, a subdomain is a flexible, low-commitment option.
A website published under a subdomain functions exactly the same as one using a custom domain. The only difference is the URL: subdomain sites will always include "thebookshelf.io" as part of their address.
Many authors use a subdomain while building their website, and finalize their domain choice later. You can use all of The Bookshelf's features, design your site, and prepare it for launch without needing to decide on your domain right away.
When choosing a subdomain, we recommend selecting something that's clear, recognizable, and aligned with your author brand—just as you would do with a custom domain.
If at any time you decide to use a custom domain for your website, you will still retain a subdomain for your account, though it will not be public-facing. It primarily serves as a backup for potential situations an author may encounter with their site or billing. For example, if you decide to renew your Bookshelf subscription, but no longer want to renew your custom domain, your site can default to your subdomain instead without ever needing to be taken offline.
Using an Existing Domain
If you already own a domain from a third-party provider and plan to use it with your Bookshelf website, you'll work under a subdomain while building your site. When you're ready to publish, contact support@thebookshelf.io and our team will guide you through connecting your existing domain and launching your site.

